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WANT ADVICE ABOUT OBJECT-ORIENTED 
I’LL ASK AN EXPERT. 


SO, ASK US. 


You already know reusable class libraries promise a 
dramatic increase in productivity and efficiency for 
professional application developers. You also know class 
libraries created with one C++ compiler can't link with code 
created by another C++ compiler. And that libraries written 
in one language can't be used with client code written in 
another language. 


But here’s something you might not know: MetaWare and 
IBM are changing all that. 


Out With The Old. In With The New. The tight binary 
coupling that exists between object-oriented class libraries 
and client code means that changes to either—no matter 
how small—require a complete recompilation not only of 
the class itself, but of all the client modules 
as well. 
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But with IBM's System Object Model (SOM) 
and MetaWare’s High C/C++ DirectToSOM 
compiler for OS/2, developers can break that 
tight binary coupling and extend the 
advantages of procedure libraries to 
object-oriented technology. 


C++, 


Ey 





Pretty amazing, right’? And right now, you think this is where 
our pitch to sell you a compiler comes in. But you're wrong. 


Information Only. And It’s Free. We know what you 
really want is information. That way you can make up your 
own mind about the benefits of SOM and the DirectTloSOM 
High C/C++ compiler for OS/2. We've prepared a white 
paper that will help. It's called Truly Reusable Objects 
Directly From C++: How to Create and Distribute Them. It's 
yours just for the asking. 


To receive your free information, call, fax, or e-mail 
MetaWare at the numbers shown below. Once you review 
the facts for yourself, you'll understand why MetaWare and 
IBM mean “objects made easy.” 


CALL 408 429 6382 
FAX 408 429 9273 


E-MAIL TECHSALES@METAWARE.COM 


FOR YOUR FREE COPY. 
TODAY. 
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Introducing VisPro/Reports, the first programmable 
report writer for VisPro/REXX,VX REXX and OS/2 REXX 


On April 28, 1993 HockWare Inc. shipped 
VisPro/REXX, the first OS/2 visual programming 
tool for REXX. Since then, we've achieved many 
other firsts. VisPro/REXX, VisPro/C and 
VisPro/C++ are the first REXX, C and C++ tools 
to incorporate drag and drop programming, an 
entity-relationship database designer, and a rich 
set of add-on objects including: spreadsheet, 
business graphics, formatted entry field, clock 
and calendar. Whether you're using REXX, 
C-Presentation Manager, or IBM's User-Interface 
Class Library, there is a VisPro product to meet 
your needs. 


* Banded report options allow you to choose 
from a rich set of headers, footers and groups. 

* Label reports allow you to select from a large 
list of Avery labels. 

* Support for multiple line text, derived fields, 
business graphics, bitmap images, rectangles, 
lines and ellipses. 

* Many object properties to choose from, 
including any OS/2 font, 16 million colors, line 
styles, fill patterns and drop shadows. 

* Wide selection of field options, International 
currency and formulas. 

* Numerous sample reports included. 


Yet Another First Report Printing is Easy 
VisPro/Reports is the latest addition to * Seamlessly print or preview reports 
the VisPro family of OS/2 F ia from any OS/2 REXX environ- 
programming products. ,_ = ow, ment including VisPro/REXX, 
VisPro users will recognize ee a S hha VX REXX and plain OS/2 REXX. 
the easy-to-use CUA'91 Zod BH It. It If}] = | * Use your favorite REXX- 
user-interface and the dragand\ “2s ~ ° S= sw, = <5 / enabled databases and third 
drop style HockWare pioneered . = = = party libraries for access to DB2, 
years ago. * “ag Jgg)*= | DBF files, EHLLAPI mainframe 

. = <= / connections and more. 
Designing Reports is Easy * A runtime DLL of less than 100K 


* WYSIWYG, free-format report design tool. 


can be distributed royalty free. 


The Complete VisPro Family 

VIG ics scarves ececes $199 
WinPrOsMEEX Galdls oo 0.s0-c.cnwsvcees $299 
VisPro/REXX Bronze .............. $99 $ 59 


VisPro/REXX Data Entry Object Pack. . $49 $ 89 
VisPro/C or VisPro/C++ SPECIAL!!! $395 $199 
VisPro Development Suite.......... $595 $499 
(includes VisPro/REXX Gold, C and C++) 


Whether you've already discovered the VisPro 
family of visual programming products or you're 
just getting to know us, meet 
our latest member, 
VisPro/Reports. And be 
the first to get where 
you're going. 






HockWare Incorporated 
Cary. NC 27512-0336 
919-380-0616 


k ™ 
are 


Putting You in Control 


Go HockWare on CompuServe 
hockware@vnet.net on Internet 
http://www.nando.net/ads/hockware 





HockWare, VisPro/C, VisPro/C++, VisPro/REXX and VisPro/Reports are trademarks of HockWare Incorporated. All other company, product and brand names are trademarks and/or registered trademarks of their 
respective holders and are mentioned for reference purposes only. ©1995 HockWare Incorporated. All rights reserved. 


Circle Reader Service Number 2 


ATR 













| 


[) Ose. 1995 
THE MAGAZINE FOR ADVANCED SOFTWAR. | 


Em DEVELOPMENT 





EDITOR'S COMMENTS 
PowerPC to the People 5 


0S/2 TOOLBOX 
Visual SlickEdit for OS/2 6 


GUI CORNER 
Manipulating Dialogues in C++ 10 


PROGRAMMING INSIDER 
Extending the OS/2 API 15 


OS/2 FOR THE POWERPC 

OS/2 for the PowerPC: Fact or Fiction 20 
By Charles Dircks 

Porting to the PowerPC 23 
By Steven Tower and John Morris 

Getting There From Here: Moving to the PowerPC 27 
By Randell S. Flint 





DATABASE DEVELOPMENT 

Building an OS/2-Based Airline Reservation System 34 
By Jim Monroe 

Normal Form and Other Mantras of Effective Database Design 50 
By Charles Meyer 

A Multi-Platform Database Library 57 
By Jake Jacob 

Database Development Tools Buyers Guide 67 


OBJECTS 
OpenDoc—More Than Just Documents 38 
By Robert C. Yeager 


SPOTLIGHT: TOOLS FOR THE POWERPC 
Tools for the PowerPC Buyers Guide 62 


PRODUCT WATCH 
New Products for OS/2 72 












Brief and 
tothe point: 


RIMSTAR was the first native OS/2 PM editor. In fact, it | and jump to errors, hex editing, and source code 
was the first GUI editor of its kind. So what's new? browser for ‘C’.... 


Introducing RiMSTAR's But why talk about features 


30-Day Free Trial offer. Right when you can try out the lead- 


now, free of charge, you can ing OS/2 editor for yourself — 


use the leading OS/2 editor free? Call now for your copy: 


for 30 days — fully functional 1-800-746-7007 Outside the 


US, call 603-778-2500 or fax 


with our syntax coloring, 


complete ANSI ‘C’ macro your order: 603-778-2408. 


language, smart C/C++ If you like it, you can 


indenting and template have the RIMSTAR Programmer's 


expansion, no limits on line Editor for OS/2 or Windows, 





“My copy of Brief has been Gernanenth retired! ; ; 
length, file size, number of Keep inthe cbad WerktAd Windows 95 and Windows NT 


For a limited time, RIMSTAR is yours —free — to use for 30 days. 
FilES OF WINGOWS, COMMPI LS —oaceecscsssssscsssscsenssssnnsnsnsnnnnnnsee SO ne ee See for only $199. 
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BY DICK CONKLIN 


Power(PC) 
to the People 


e've followed with interest IBM's quest | PC beta users to tell us 
Wie: a portable, microkernel-based soft- about their migration from 
ware strategy. The concept of Work- | OS/2 Warp to the PowerPC 

place OS has been around for two years now, but = Edition—Sundial Systems, — 
we haven't had a real life example—until now. | AdeptSoft, and Pinnacle 
Almost everyone agrees that this is the right way | Technology. Are you ready 
to go: an operating system personality builtona | for PowerPC? Judge for 
microkernel built on a hardware base. A radical- —_ yourself. 
ly new hardware base, such as the RISC-powered Dick Conklin 
PowerPC, meant a new version of OS/2 was nec- 
essary. But how much work would it take to Dre eee 
make existing applications run? Would Work- | 
place OS preserve the OS/2 API as it had 
promised? Would this pave the way for some 
super-performing multimedia applications? 

Well, the wait is over. IBM produced the oper- 
ating system, first called OS/2, for PowerPC and, 
later, officially named OS/2 Warp Connect 
(PowerPC Edition). MetaWare delivered a 
C/C++ compiler. The main requirement was that 
your OS/2 application had to be a 32-bit pro- 
gram. Then, you simply ported over to PowerPC 
and...? 

But let's let some of our pioneering developers 
finish the story. We asked three of IBM's Power- 
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In this issue, our OS/2 Toolbox column reviews MicroEdge’s Visual SlickEdit for OS/2. 


By GUY SCHARF 


Visual SlickEdit 
for OS/2 





Guy Scharf 


icroEdge’s Visual SlickEdit for 
OS/2, version 1.72, is a power- 
ful, graphical, programmer's 
editor for OS/2. The editor is extremely flex- 
ible, allowing you to easily tailor it to your 
own style. Language support is extensive; a 
version control interface is built in; color 
syntax highlighting is included; and a Slick- 
C programming language allows you to 
modify and extend the editor as needed. 
Smart syntax expansion writes some of your 
code for you. There’s even a spell checker! 

Visual SlickEdit offers a broad range of 
cross-platform support than most other edi- 
tors. MicroEdge has versions of Visual 
SlickEdit for Windows 3.1, NT, and 95 as 
well. A related product, the character-mode 
SlickEdit editor, is available for DOS and 
more than 15 flavors of Unix. 

Visual SlickEdit is supplied on three 
diskettes, and installation is straightforward. 
A complete installation takes 6.8 megabytes 
on your hard disk; a minimum installation 
requires 4 megabytes. A 25-MHz 486 is rec- 
ommended as the minimum system. I| tested 
Visual SlickEdit for OS/2 on a 50-MHz 486 
with 32 megabytes of memory and found 
performance quite acceptable. 





CONFIGURING VISUAL SLICKEDIT 
When you install Visual SlickEdit, you select 


the keyboard emulation that you prefer to 


use. CUA, Brief, Emacs, SlickEdit, and vi are 


supported. You can change your selection - 


later using the Configuration dialog (see 
Figure 1). The keyboard emulation is imple- 
mented as bindings between keys and inter- 
nal functions. You can easily alter these 
bindings to produce any keyboard you want. 
All of the keystroke combinations that I refer 
to here are for the CUA keyboard emulation 
style; other emulations may use different 
keystrokes. The manual and online help de- 


scribe the keystrokes for each keyboard emu- 
lation. You can also ask Visual SlickEdit to 
create a file with the active definitions. 

Figure 2 shows the main editing screen. 
You can configure the menu, button bar, 
scroll bars, and more using the Con- 
figuration dialog. An unusual feature is that 
you can alter Visual SlickEdit’s own dialogs. 
The Slick-C programming language includes 
dialog support. Since Visual SlickEdit’s own 
dialogs are created using the same tool, you 
can modify them to obtain the appearance 
you want. 

Using the File Extension configuration 
option, you can tailor the Visual SlickEdit’s 
behavior based on the file extension. Figure 3 
shows how I have defined the behavior for C 
files: for example, tabs are at intervals of four 
columns. Using other dialogs, you can select 
which programming style variation you want 
for syntax expansion, such as where the 
braces should be located after an if statement. 

The dialogs shown only touch the sur- 
face of the ability to configure Visual Slick- 
Edit. In my testing, | found minor features 
that did not operate the way I wanted them 
to. In all cases, | was able to change the con- 
figuration so that I got the behavior that I 
wanted. Finding the right way to request the 
change was not always obvious, but 
MicroEdge technical support was able to 
direct me to the solution quickly. 


EASE OF USE 

Visual SlickEdit is easy to use, with lots of 
tools to help the programmer. For safety, 
backups are made when a file is saved and 
optionally on a timed basis as well. 

The editing functions are powerful. 
Line, block, and character selection are all 
available. The new SmartPaste function is 
especially nice: paste code into an existing 
function and it is automatically indented cor- 
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rectly for the location you are pasting it into. 
When you need word processing, automatic 
word-wrap, margins, and justification are 
available. Undo and redo is supported for up 
to 32,000 events. While that’s not unlimited, 
that’s more than I ever edit in one session. 

Color syntax highlighting clearly sepa- 
rates comments from code and immediately 
shows any errors in closing a comment or 
string. Syntax expansion and indenting work 
well. Type if followed by a space and Visual 
SlickEdit inserts: 


if () 
{ 
} 


in your program. 

Support is provided for C, C++, Pascal, 
Fortran, Basic, dBASE, Modula-2, Assembly, 
COBOL, and Ada. The manual describes 
how you can add support for other lan- 
guages as well. 

Visual SlickEdit allows you to group 
files together in projects. In a project configu- 
ration dialog, you define what files are part 
of the project. For each project, you can 
define the make command for the project, or 
the commands to compile individual mod- 
ules, in a project configuration dialog shown 
in Figure 4. With the project defined, Ctrl+M 
compiles the project. 
Since this is OS/2, 
you can continue edit- 
ing while the compiler 
is running. Compiler 
output is placed ina 
process buffer, and a 
window is opened for 
the buffer. Double- 
click on any message, 
and a window is 
opened showing the 
module and line in 
error. Press the key 
for next error or previ- 
ous error, and you are 
moved to the next or 
previous line that gen- 
erated a message. 

Visual SlickEdit 
supports several ver- 
sion control systems, 
including TLIB and 
PVCS for OS/2. Using 
the Project menu, you 


can check files in or Figure 1. Configuration dialog. 
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out. I especially liked that a window is dis- 
played for you to enter the description of the 
change when you check a file into PVCS. The 
editor doesn’t simply start a command win- 
dow and let you deal with the prompts—it 
effectively wraps a graphical front-end 
around the character mode version control 
system. As with all of Visual SlickEdit, you 
can configure the version control check in 
and out process to operate as you wish. 

Tags allow you to locate and edit func- 
tions quickly. You can generate tags for 
individual files or for an entire project. Once 
the tag file has been created, position your 
cursor on a function name, press Ctrl+. and 
a window will be opened showing that 
function. 

Visual SlickEdit gives quick access to 
OS/2 programming references. Place the 
cursor on a function or symbol, press 
Ctrl+F1, and the help entry for that function 
will be displayed. This lets you look up the 
parameters for WinCreateWindow or fopen 
quickly. 

Searching capabilities are powerful. 
Regular expressions are supported. The 
search can encompass one file or many files. 
When you are searching multiple files, a 
search result window, showing all matches, 
is displayed. Pick the match of interest and 
press the GoTo button to open that file. 
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Figure 2. Main editing screen. 

Incremental searching is especially 
convenient. Just start typing and the 
cursor moves to the next location in 
the file that matches what you have 
typed so far. 

A calculator is included, too. The 
calculator supports hexadecimal, octal, 
and binary computations as well as 
decimal. Calculations can mix different 
representations. If you don’t need a 
full calculator, simple expression eval- 
uation is included on the command 
line. Type “math 2*2,” press return, 
and Visual SlickEdit adds “=4" to your 
statement. Or type “math 0xA003,” 
press return, and the decimal value 
will be displayed. The hexadecimal 
and decimal values are always dis- 
played on the status line below the cal- 
culation, so you can always see both 
representations. This is very useful 
when using APIs that have error 
returns documented sometimes as dec- 
imal and sometimes as hexadecimal. 

One of the less visible but power- 
ful features is the alias facility. In its 
simplest form, aliases can be used for 
command line expansion. For exam- 
ple, you can define “Iw” to be an alias 
for a fully qualified path to a file name. 
Select File/Open, type “lw,” press 
Ctrl+Spacebar, and the fully qualified 
name will be substituted for “Iw.” A 
more complex use would be to auto- 
mate code or documentation templates 
in a file. You could type “f,” press Ctrl- 
Space, and create a function header for 
the language you are using. I plan to 
use this feature for documenting func- 
tions and creating skeleton programs. 

Visual SlickEdit also has text and 


binary file comparison, a file manager, 
split windows, begin/end structure 
and brace matching, and more. 

Macro programming is the key to 
extending the power of Visual 
SlickEdit. The Slick-C macro language 
is a typeless, C-like language. To ease 
macro creation, macros can be recor- 
ded from keystrokes and saved for 
later editing and expansion. Macros 
are source and binary code compatible 
on all OS/2 and Windows platforms, 
making it easy to develop tools for 
cross-platform development. More 
than 130 macro files are included with 
Visual SlickEdit. These all serve as ex- 


amples on how to program in Slick-C. 

The macro programming lan- 
guage itself is straightforward. 
Programming it does require, learning 
a large set of Visual SlickEdit func- 
tions. For example, this small macro 
inserts // at the beginning of every line 
in a marked block: 


defmain() 
/* Puts // in front of selected lines 
*/ 
{ 
if (begin_select()) return(**); 
bl=p_line; 
end_select() 
el=p_line; 
for (i=bl;i<=el;++i) { 
p_line=i; 
begin_line(); 
keyin i / i i 
} 
deselect(); 
} 


DOCUMENTATION 
Visual SlickEdit comes with a 650-page 
manual of which 130 pages cover con- 
figuration and use. The majority of the 
manual describes the Slick-C program- 
ming language. The configuration sec- 
tion contains the information you need 
to use Visual SlickEdit effectively. 
However, this section is not well orga- 
nized, so you may need to hunt 
around a bit for the information you 
need. I did find the table of contents 
useful for locating information. The 
documentation is clearly written and 
easy to understand. 

The programming language is 





Figure 3. File extension options. 
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Figure 4. Project options. 


described in 80 pages; the remaining 
570 pages are an alphabetical reference 
of all of the macro functions. The lan- 
guage description provides a good 
introduction to the language and the 
philosophy behind it. A nice touch is a 
section describing common program- 
ming mistakes. These mistakes are 
used to illustrate how the language 
works. In the reference section, the 
macro functions are briefly described 
in one or two sentences. More detailed 
explanations and examples are 
included for more complex macros. 
Slick-C is yet another language to 
learn—I would have preferred 
REXX—but it appears to be relatively 
approachable. Visual SlickEdit’s macro 
recording provides a good way to get 
started learning the language. 


WARTS AND BLEMISHES 

Visual SlickEdit for OS/2 is very simi- 
lar to Visual SlickEdit for Windows 
and reflects a Windows user interface 
design. Configuration involves an 
extensive set of nested dialogs. As 
usual with nested dialogs, it is easy to 
forget exactly where you are. The 
OS/2 notebook control could organize 
configuration information much more 
effectively. Other dialogs, such as the 
File Open dialog, reflect a Windows 
design. 

Visual SlickEdit uses the Multiple 
Document Interface (MDI) paradigm 
for organizing windows. All windows 
that you open are children of the client 
area of the main Visual SlickEdit win- 
dow. You can arrange the windows as 
you wish; Window menu items will 


arrange all windows as cascaded or 
tiled. The MDI main window reduces 
the maximum vertical size of each 
window you open, as the main win- 
dow has tool bars, status lines, and 
more. I would prefer to see windows 
be children of the desktop instead, as 
is the conventional practice for OS/2. 
The user would then be able to use 
screen space more effectively. 

While Visual SlickEdit emulates 
keystrokes for Brief, it will not execute 
Brief macros nor is a conversion utility 
available. You must thus convert Brief 
macros manually, learning the Slick-C 
language along the way. However, the 
product includes a very rich set of 
macros. I found that Visual SlickEdit 
had equivalent functions for some of 
the Brief macros that I rely on when 
writing programs. 

The tag function is overly gener- 
ous about identifying functions. In my 
testing, it “found” function definitions 
in comments. The only way to be cer- 
tain of what is a function definition is 
to actually parse the file using the syn- 
tax rules of the language. This is 
apparently not done. 

I normally set my default system 
font to 8.Helv rather than using the 
default System Proportional font. I 
could not do that with Visual 
SlickEdit. When I changed the system 
font, text and spacing in some dialogs 
were altered so much that I could not 
read the dialog at all. The problem was 
not the usual text clipping but a more 


reduce the risk of two people changing 


the same file at the same time. The sec- Eff 


ond copy of the file is opened in read- 
only mode and is refreshed with * 
changes made on the other copy. I saw 
a few odd behaviors, such as the 
refresh not always occurring, but over- 
all I found the network support to be 
satisfactory. 


TECHNICAL SUPPORT 

MicroEdge supports Visual SlickEdit 
on CompuServe. GO SLICKEDIT and 
select message and library section 13, 
MicroEdge Inc. I found several mes- 
sages posted on the forum each day. I 
posted several questions and reported 
two problems. My questions were 
answered the next day. Updated ver- 
sions of Visual SlickEdit or macros to 
fix problems were uploaded to the 
library within a day or two. I could 
hardly ask for better support! 

As this review was completed, 
MicroEdge released an update to sup- 
port the IBM WorkFrame product. 
The update is available for download- 
ing from their forum. 


SUMMARY 

I have resisted converting to a graphi- 
cal editor because of my large invest- 
ment in Brief macros for documenting 
and organizing code. With Visual 
SlickEdit, I may finally take the plunge 
and convert my macros. Visual Slick- 
Edit is powerful, flexible, and a delight 
to use. It’s a definite keeper for my 
toolbox. 


Guy Scharf is president of Software 
Architects, Inc., a software development firm 
specializing in developing OS/2 Presentation 
Manager applications for vendors and busi- 
ness. He can be reached at 76702.557@com- 
puserve.com or at Software Architects, Inc., 
2163 Jardin Drive, Mountain View, CA. 
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ecisions, decisions, decisions. While 
investigating the possibility of pro- 
viding C++ wrappers for the print 
API discussed in our previous three 
columns, we reached the conclusion that 
such an effort was premature in light of our 
abundant use of dialogues. As Mark’s five- 
year-old nephew, Andrew, might put it, 
“Ding, I've got it!” A bell went off in our 
collective heads. What was that bell? 
Wouldn’t it be nice to investigate and de- 
velop a set of C++ classes that have the ca- 
pability of processing a dialogue template, 
thereby generating the appropriate C++ 
control classes that wrap the controls in the 
template? Yup! We thought so too. 
Therefore, our goal is to provide you with 
the necessary classes and implement them 
using the IBM Open Class Library. 





THE INVESTIGATION 

There are a number of ways we can tackle 
this assignment, with each way achieving 
the common goal: 

1) Load the dialogue template using a 
class derived from IFrameWindow and use the 
nested class IWindow: :ChildCursor to iterate the 
child controls in the dialogue. Use the 
WinQueryClassName API to determine the type 
of control based upon its Presentation 
Manager window class, subsequently creat- 
ing C++ objects for each control. 

2) Derive a new class from IFrameWindow 
and, in the constructor for this new class, 
load the dialogue. Provide a member func- 
tion that loads the dialogue template from 
the resource via the DosGetResource API. Use 
the information in the dialogue template to 
iterate the various child controls in the tem- 
plate and create a corresponding C++ object 
for each control. 

3) Derive a new class from IFrameWindow 
and, in the constructor for this new class, 
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load the dialogue template from the re- 
source via the DosGetResource API. Use the in- 
formation in the dialogue template to iterate 
the various child controls in the template 
and create each control using the 
WinCreateWindow API. A corresponding C++ 
object can be created for each control by 
using the window handle returned from 
WinCreateWindow. 

Each solution has its merits, as well as 
its faults. The first solution is more of a C++ 
solution than the other two, as most, but not 
all, of its implementation is in C++. The sec- 
ond solution seeks to take advantage of 
Presentation Manager's support for dia- 
logues, and the third solution places all the 
dialogue processing under your control. We 
chose the second solution for a number of 
reasons: 

*« Taps Presentation Manager's dialogue- 
processing capabilities 

* More intuitive for C programmers who 
have dialogue backgrounds 

¢ Potential bridge for C programmers who 
are seeking to transpose their work to 
C++ 

¢ Performance. 


ON TO THE CHASE 
The base class that we developed for the 
processing of dialogue templates, Dialog, is 
derived from IFrameWindow, taking advantage 
of some of the support that IFrameWindow al- 
ready has for dialogues. The Dialog class 
constructor, shown in Figure 1, is imple- 
mented using various C++ classes. The dia- 
logue is loaded by the member function, 
TResourceLibrary::loadDialog. This function uses 
the WinLoadDlg API to perform the load. If the 
load fails, IResourceLibrary::loadDialog will 
throw an IiccessError exception. 

Why do we load the dialogue and dia- 
logue template in separate steps? Can't we 
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load the template and create the dialogue in 
one step to help our performance? Nope! 
We can only iterate the child controls in the 
dialogue template to create C++ objects after 
the base Dialog class is constructed. We are 
calling virtual functions that may be overri- 
den in a derived class, which means the de- 
rived class must exist, or we end up calling 
the virtual functions in the base class. We 
will discuss this approach in more detail 
later. 

A couple of other points from the con- 
structor in Figure 1 that are worth mention- 
ing are the IThread: :current()::initializeGUI(), 
and the IFrameWindow::start function call. 
IThread: :current().initializeGUI() initializes 
the Presentation Manager environment by 
calling the WinInitialize and WinCreateMsgQueue 
APIs. The IFrameWindow::start function creates 
a new frame handler and adds it to the 
frame window, initiates message handling 
for the window, and adds the window to the 
internal window list that is maintained by 
the IBM Open Class Library. 


TO ITERATE OR NOT TO ITERATE 

Once we have loaded the dialogue and the 
dialogue template, we can iterate the tem- 
plate and construct the corresponding C++ 
objects for the child controls. We use the in- 
formation contained within the template to 
determine the number of child controls, the 
type of control, the individual control IDs, 
and the control style. Why is the control 
style important you may ask? You must use 
the style to determine the type of button and 
static control you are processing, because 
multiple button and static controls rely 
upon the WC_BUTTON and WC_STATIC 
window classes, respectively. 

In our default implementation, we have 
chosen to iterate the template and construct 
C++ objects for each of the child controls, 
immediately following the loading of the di- 
alogue. The dialogue is loaded in the Dialog 
constructor, and the C++ objects are con- 
structed in Dialog: :createControlsFromlemplate. 
Using the default implementation, C++ ob- 
jects are constructed for each child control 
that has an ID other than -1; child controls 
with an ID of -1 are skipped. However, you 
can defer the construction of the C++ objects 
until they are needed, by simply leaving out 
the call to Dialog: :createControlsFromTemplate. 
When you need to construct a C++ object, 
member functions are provided that allow 
you to easily create an object for a specific 





child control. All you need to supply these 
member functions is the child control’s ID. 
Each of these functions is identified by the 
"WithId" suffix. An example is Dialog:: 
checkBoxWithId, as shown in Figure 2. We will 
discuss the elements of this function in more 
detail later. 

During the iteration of the child con- 
trols in the dialogue template, we use the 
of fClassName field within the DLGITEM structure 
to determine the type of control. (This tech- 
nique is the same used in the PDSGetTemplate 
function that is found within the support.c 
module from previous article sources.) If the 
ID is not -1, we construct a C++ object using 
the constructor that is designed for the cre- 
ation of an object from a dialogue template. 
Each Presentation Manager control wrapper 
within the IBM Open Class Library has this 
type of constructor that accepts a window 
ID and a pointer to the parent window ob- 
ject. After the object is created, we call the 
member function, IWindow: :setAutoDeleteDb ject, 
which results in the destruction of the object 
when the Presentation Manager window is 





Figure 1, Constructor for dialog. 
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Figure 2. Dialog: :checkBoxWithId member function, 


destroyed. Our final act is to calla 
protected virtual function, passing a 
pointer to the newly created object. 
The default implementation of these 
functions does nothing. You must 
override them in a class derived from 
Dialog to add the desired behavior. A 
small snippet of code shown in Figure 
3 illustrates these steps in relation to 
the check box control. We must use 
the style as well as the button window 
class to identify the check box. 


SUPPORTED CONTROLS 

All of the controls that are supported 
by the Dialog class are listed in Table 
1, The controls that are not supported 
are the valueset and most of the multi- 
media controls. The valueset is not 
supported since it is not yet supported 
by the Open Class Library. However, 
you can implement support for the 
valueset via the valueset C++ wrapper 
that is discussed in the book, OS/2 
C++ Class Library Power GUI Pro- 
gramming with C Set++. 





Figure 3. C++ object construction. 
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WHAT ABOUT CUSTOM CONTROLS? 
Custom controls are also supported to 
an extent. We detect the presence of a 
custom control in the Dialog class con- 
structor by interrogating the value of 
the cchClassName field of the DLGITEM 
structure. If it is nonzero, we assume 
that it is a custom control and call the 
member function, Dialog: :customControl, 
passing the window ID and a constant 
reference to the class name string as 
parameters. The default implementa- 
tion of this function does nothing. You 
must override this function in a class 
derived from Dialog, to properly 
process the custom control. 


DEFERRED CONSTRUCTION 

OR IS IT A QUERY? 

In Figure 2, we show a member func- 
tion, Dialog: :checkBoxWithId. This func- 
tion and the other "xxxXxxWithId" func- 
tions play multiple roles. You can use 
them for deferred construction of C++ 
objects or for querying an object that 
already exists. In Dialog: :checkBoxWithId, 
IWindow: :windowWithOwner is called to ob- 
_ tain a pointer to the check box 
object that corresponds to the 
passed ID. If a NULL pointer is re- 
turned, we attempt to construct a 
check box object, and call 
IWindow: :setAutoDeleteObject, to 
allow the IBM Open Class Li- 
brary to manage the destruction 
of the object when the check box 
window is destroyed. Why do we 
say attempt, and why do we not 
throw an exception on a failed at- 
tempt? If the object construction 
fails, the IBM Open Class Library 
throws an exception for us. If a 
non-NULL pointer is returned by 
IWindow: :windowWithOwner, the call to 
Dialog: :checkBoxWithId is, in es- 
sence, a query, and the pointer is 
returned to the caller. 


SAMPLE DIALOGUE 
The sample driver application il- 
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lustrates some of the things previously 
discussed. A new class, SampleDialog, is 
derived from our base Dialog class. 
SampleDialog is designed to support a 
sample dialog that we have cobbled 
together to show how to provide con- 
trol interaction from a C++ perspec- 
tive. As mentioned, we create C++ ob- 
jects for the child controls by calling 
Dialog: :createControlsFromlemplate. This 
function is called from within the 
SampleDialog constructor. 


GETTING A HANDLE ON THE HANDLERS 
Once we have the C++ objects con- 
structed, our next step is to attach gen- 
eral purpose handlers to process the 
various window events generated by 
the controls. The first handler class we 
would like to attach is a command 
handler, ICommandHandler. We use an 
ICommandHandler to process the com- 
mand, WM_COMMAND, event that is gener- 
ated by clicking on the “Query” or the 
“Cancel” push button shown in Figure 
4. In our driver application, we derive 
a new class, SampleCommandHandler, from 
ICommandHandler and override the mem- 
ber function, ICommandHandler: : command. 
SampleCommandHandler::command processes 
the command event, and as you may 
notice when you preview the driver 
application, it bears a strong resem- 
blance to a window procedure. 
SampleCommandHandler is attached to the 
sample dialog by calling IHandler: :han- 
dleEventsFor from within the SampleDia- 
log constructor. 

The cancel processing within 
SampleCommandHandler::command is, as you 
have guessed, a dismissal of the dia- 
logue. The query processing, although 
more involved, is still quite simple. 
We query the selected item’s text 
within the combo box and the list box, 
as well as the current value in the nu- 
meric spin button. We display the text 
and value with the multi-line edit 
(mle) control. 

Note that the return code for a 
handler has significance. A return 
code of false indicates that the event 
may be dispatched to other handlers 
for processing or that it may be 
processed by the default window pro- 
cedure. A return code of true indicates 
that processing of the event has fin- 
ished. However, if you return true, 
you may also be required to set an 
event result via IEvent::setResult. Most 
events do not require the setting of re- 
sults, but be aware of those that do. 

The next handler class we would 
like to attach is a select handler, 
TSelecthandler. We use an ISelectHandler 
to process the selection, LN_SELECT, noti- 
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Figure 4. A handler is selected by generating an item in the list box. 


fication event that is generated by se- 
lecting an item in the list box shown in 
Figure 4. In our driver application, we 
derive a new class, SampleSelectHandler, 
from ISelectHandler, and override the 
member function, ISelectHandler: :se- 
lected. SampleSelectHandler is attached 
to tn sample dialog by calling 
IHandler: :handleEventsFor from within 
the SampleDialog constructor. 

SampleSelectHandler::selected pro- 
cesses a selection event and writes the 
selected item's text into the static text 
control. 


YOU ARE BEING OBSERVED 

Most of us have dealt with the nu- 
ances of control event processing at 
one time or another. Since many of the 
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notification values overlap between 
controls, you must determine the con- 
trol type prior to tackling the notifica- 
tion value. We use the notification 
framework in the IBM Open Class 
Library to remedy that headache. 
Rather than using integers to repre- 
sent the notification event, unique 
strings are used instead. 

We derive an observer class, 
SampleObserver, from I0bserver, overrid- 
ing the pure virtual function, I0b- 
server: :dispatchNotificationEvent. Sample- 
Observer: :dispatchNotificationEvent contains 
our logic for processing the ICir- 
cularSlider::valueId notification. We 
use the information that is passed by 
the notification event class, INoti- 


ficationEvent, to update an entryfield, 
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as well as a progress indicator (a 
read-only slider). 

We enable observer notification 
within SampleDialog::circularSlider by 
calling ICircularSLider: :enableNotifica- 
tion. Our observer, SampleQbserver, is at- 
tached to the circular slider in this 
function via I0bserver: :handleNotifica- 
tionsFor. We encourage you to explore 
the code, as the sample driver should 
make things clearer. On a final note, 
you need to attach the observer to the 
control you are observing. It does not 
work if you attach the observer to the 
owner of the control. 


HANDLING DIALOGUE INITIALIZATION 
We've purposely avoided the issue of 
handling dialogue initialization. Our 
general purpose handlers cannot be 
used to process the dialogue initializa- 
tion, WH_INITDLG, event, since we are 
specifying WinDefDlgProc as the dialogue 
procedure when we call IResourceLi- 
brary::loadDialog. Special logic is re- 
quired to enable initialization process- 
ing, and because this logic has already 
been implemented elsewhere, we do 
not want to “re-invent the wheel”. An 
excellent implementation is provided 
in the book, OS/2 C++ Class Library 
Power GUI Programming with C Set++ 
on pages 464-471. 


CONCLUSION 

The sample driver application, al- 
though simple in scope, illustrates 
some powerful concepts. A common 
problem faced by users of the IBM 
Open Class Library is how to support 
legacy resources from the context of a 
C++ class library. Hopefully, we have 
given you a set of classes that you can 
use to implement support for your 
legacy resources from a C++ class 
library. 

One possible extension of the 
Dialog class is to convert a dialogue 
template into a canvas. As is the case 
for dialogue initialization, we will 
avoid this issue and leave it as an ex- 
ercise for the brave at heart. 

Please keep those calls, letters, 
and suggestions coming, and we will 
try to incorporate your suggestions 
into future columns. 
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In this issue’s “Programming Insider,” we'll explore how IBM's new Developer API 


Extensions help you, IBM, and the programming community whether you already have 
0S/2-exploitive applications, are writing for Win32, or whatever your plans may be. 


By DAVID E. REICH 


Extending the 


OS/2 API 


ack in May, at the IBM Technical 
Interchange in New Orleans, IBM 
announced extensions to the OS/2 
API set. They were dubbed “IBM Developer 
API Extensions”. Whatever they’re called 
when they’re released, they are simply new 
OS/2 APIs for use by application develop- 
ers. These APIs happen to have the same 
names, parameter lists, and functions as 
their Win32 counterparts. 





WHAT ARE THESE EXTENSIONS? 

The developer API extensions are just that. 
They are new APIs, or programming inter- 
faces, for use by any application developer. 
IBM is always adding new APIs to the sys- 
tem. Some are newly published interfaces to 
existing function (the oft-mentioned “docu- 
ment the undocumented interfaces” re- 
quest), and some are interfaces to new func- 
tion added to the operating system. These 
developer extensions are no different. 

The new function list, published at the 
IBM Technical Interchange and found in a 
White Paper on the IBM Software De- 
veloper’s home page on the World Wide 
Web at http: / /www.austin.ibm.com/devel- 
oper, is a list of over 700 APIs and 300 mes- 
sages that correspond in interface and func- 
tion to Win32 APIs and messages with the 
same names. The idea behind this is to cre- 
ate a level of source code compatibility be- 
tween applications written for Windows NT 
or Windows 95 and OS/2. 


WHY? 

IBM understands that this API/ message list 
will not create complete source code com- 
patibility, and many people have ques- 
tioned the motivation behind fundamen- 
tally supporting Win32 APIs in OS/2. The 
major concern among developers is, “Isn't 
this conceding the API ‘wars’ to Microsoft, 
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and isn’t IBM now letting Microsoft take 
control of the API?” This question needs to 
be asked, and the answer, while a religious 
subject for many, makes sense when viewed 
in the big picture. 

Let’s face it. There are many OS/2 ap- 
plications on the market. There are many 
more Windows applications. It is a simple 
matter of economics. With limited resources 
on the part of developers, the migration is 
to the larger installed base. For now, that is 
Windows. With the single-threaded, 16-bit 
architecture of Windows, APIs aside, there 
are fundamental architectural issues that 
made source code compatibility impractical 
before now. Even if the API were identical 
between OS/2 and Windows, the “16-bit- 
ness” of the applications and the single- 
threaded architecture of Windows would 
create OS/2 applications that would not ex- 
ploit the advanced functionality offered by 
OS/2 and as such, no compelling reason for 
people to buy them. 

Now that applications supporting mul- 
tithreading and 32-bit function are being 
developed, it makes much more sense to do 
something like this now rather than earlier. 
So why does IBM want to support Win32 
APIs? 

The plain fact is that there are develop- 
ers creating Win32 applications. In the past, 
OS/2 applications have not kept pace with 
the functionality that was offered in their 
Windows counterparts, because Windows 
was being developed for first. What the 
market was seeing was a MyApp version 
5.0 for Windows, while version 4.0 was the 
current native OS/2 version of MyApp. 
This could not continue if OS/2 was to 
thrive and grow. 

The primary hurdle is money. (Isn't it 
always?) Maintaining two sets of source 
code to do the same thing on two different 
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platforms does not make financial 
sense, If one could leverage the source 
code and reduce the cost to keep the 
same features in both OS/2 and 
Windows versions of the same appli- 
cation, it would, to a considerable ex- 
tent, level the playing field to get ap- 
plications on OS/2, with the same 
level of function. This is better for 
both OS/2 and application vendors in 
that they can sell more. 

The Developer API Extensions 
add new functions to OS/2 (such as 
common dialogs, DDEML, and Re- 
gistry functions, among others) and 
provide interfaces to the existing 
function so that you can just recom- 
pile a significant portion of your ap- 
plication and have native OS/2 func- 
tionality. In fact, IBM analyzed over 
nine million lines of shipping 
Windows application source code to 
determine which list of functions to 
support first, in order to create an ap- 
proximate 80% common source code 
base. The other 20% will be operating 
system-specific function, such as 
Workplace Shell exploitation, as well 
as other functions the other platform 
does not support. Figure 1 shows how 
you can manage your source code ef- 
ficiently to make the most use of both 
environments. 

So, in getting back to the question 
of conceding the API to Microsoft, 
IBM is tactically supporting the APIs 
that enable inexpensive migration to 
OS/2. This provides the buying pub- 
lic with applications that have the 
same functions on both OS/2 and 
Windows and lets them choose the 
platform that best fits their needs. No 
longer does the application have to 
dictate the platform, and users who 
have their operating environment 
provided for them can use your appli- 
cations on either. 


ADVANTAGES 
Some of the advantages for you, the 
programmer, are reduced cost for 
multiple platform source code, lower 
product documentation costs, and 
more function added to OS/2. After 
all, if the application is common in 
features across platforms, why rewrite 
and republish the documentation? 
Another advantage is for custo- 
mers, because there are lower learn- 
ing curves (or one curve for cus- 
tomers with multiple operating 
system installations), and there are 
products that are up to date function- 
ally. There may be customers who 
have standardized on an operating 
platform (or may be contemplating 
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movement to another), and with your 
programs, you can be there whether it 
be Windows or OS/2. The choice is 
even easier for the customer, knowing 
your application is just as functional 
on both systems and with no addi- 
tional learning for users. 


HOW CAN YOU USE 

THESE EXTENSIONS? 

The API extensions are just new func- 
tions in the operating system. As 
stated previously, some of the APIs 
are just new entry points into existing 
function, with new names and para- 
meter lists that match what the Win32 
APIs use, and some have new func- 
tion underneath. Examples of new 
function are the Find and Replace dia- 
log, the Print dialog, and DDEML 


see how to structure your code to 
maximize your investment in source 
code and leverage two platforms at 
once, 


THE FUTURE 
So what's IBM getting at with all of 
this? Basically, developers should not 
have to choose which platform to re- 
lease an application. With a common 
source code base, you can support 
different platforms. After all, that is 
where the software world is heading: 
reuse and portability. | 
For your procedural code base, 
the Developer API Extensions provide 
that portability. Using a standard C or 
C++ compiler, you can cross compile 
the platform independent code (using 
the extensions) and exploit the appro- 





Figure 1. How to manage your source code efficiently. 


functions to simplify the use of 
Dynamic Data Exchange (DDE). 
Many programmers have requested 
more common dialogs in OS/2 in ad- 
dition to the Font and File dialogs al- 
ready present, and these, with the 
many new functions, provide a com- 
plete and robust programming model. 

Using the extensions is easy. 
Because they are just new APIs, you 
can use them as you would any other. 
It's as simple as that. While at the 
time of this writing, the entry points 
are not shipping in a publicly avail- 
able version of OS/2, IBM plans on 
adding these to future OS/2 versions. 
You can make use of them in a beta, 
however, to develop your applica- 
tions. Even if you don’t have a beta, 
you can simply adhere to the API list 
in your development and cross com- 
pile for the other platform when 
you're done. Refer back to Figure 1 to 
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priate platform with the other part of 
your code. This lowers the entry point 
into other markets where you might 
not otherwise want to enter, given the 
costs of a complete rewrite. 

If you are already making a move 
to objects, the IBM Open Class prod- 
uct, along with OpenDoc, will pro- 
vide you platform independence. IBM 
Open Class will be on OS/2, Win- 
dows, and other platforms, just as 
OpenDoc is headed there as well. I try 
to stay away from commenting about 
things that are not yet shipping, but 
in the context of mapping out a strat- 
egy for you, and “Designing High- 
Powered OS/2 Warp Applications” (a 
topic that is near and dear to my 
heart), while retaining the ability to 
move to many platforms at a negligi- 
ble cost, I'll tread softly on that line. 

So, for procedural code, the De- 
veloper API Extensions get you com- 
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— Hurwitz Consulting Group, Inc. 
December 1993 





Solaris « Motif/Sun SPAR 


“Honestly, | don’t know how 
| would test this application 
without QA Partner...” 
— Christine Comaford 
PC Week, August 15, 1994 


Sun Intel 


Motif/ 


information on QA Partner today. 


i) A, Partner is a registered Chere k of Segue Sobttware, bree 
‘4 | ss = 


it li nbuce WaheiT ara pr uct ti 


oe 
o 
Oo 
= 

* 


“Given our druthers, we would use 
QA Partner as our one in-house 
testing system.” 

— Tim Parker, UNIX Review 
January 1995 


“,..5egue’s QA Partner. 
The hands-down winner when it 
comes to technical prowess.” 


THE INTEGRATED QA TESTING PLATFORM — FOR YOUR PLATFORM 


— Tim Sylvester, Client Server Today 


February 1995 
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Fast Visual Application Development 
for OS/2 and DB2 


If you're looking for fast and easy application 
development for OS/2, then take a look at the award- 
winning Watcom VX*REXX visual development 
environment. VX*REXX lets you build applications to 
exploit the graphical user interface, multi-threading, 
and multi-processing power of OS/2. VX*REXX 
Client/Server Edition gives you the added power to 
access DB2 or other database systems, manipulate the 
data, and chart the results at lightning speed. 
“We like VX*REXX. Using it for development feels like 
driving a Porsche: it’s fast, it’s compact, everything's 
in the right place, and it makes us look good, too.” 
Peter Coffee, PC WEEK 


Designed to Meet Your Needs. 

Watcom VX*REXX combines a project management 
facility, visual designer and an interactive debugger to 
deliver a highly productive visual development 
environment. The Client/Server Edition includes 
additional powerful objects so you can rapidly create rich GUI database 
applications. You can create OS/2 client applications which connect to 
DB2/2 or DB2/6000. Use IBM's DRDA support on OS/2 to access DB2 for 
MVS, DB2/400 for AS/400, and DB2/VSE and VM (SQL/DS) for VM and 
VSE. Also supported are Watcom SQL and ODBC-enabled databases’. 
“Overall, this edition of VX*REXX for OS/2 is an outstanding visual 
client/server development platform.” Nicholas Petreley, InfoWorld 





* Over 2 dozen objects, * Easy to learn event- * Graphically create GUA'91 
including CUA’91 driven programming Presentation Manager 
containers, notebooks, model with complete objects, quickly 
pop-up menus and more — on-line documentation customize their properties, 

*(ntegration and control §=«*Supportfor professional © and easily attach REXX 
of existing applications multi-threaded, multi- procedures 


through DDE, keystokes 
or REXX API's 


windowed and drag-and- 

drop enabled applications 
« Code reusability through 

section and file sharing 


« Package your application 
as an EXE or PM macro for 
royalty-free distribution 








Point. Click. And Presto! 

To create an application you draw user interface objects, customize their 
properties using standard OS/2 notebooks, and define their event code using 
powerful drag-and-drop programming. To add database access just draw a 
query object, visually design a SQL query, press OK and presto— your 
window is automatically populated with objects that are bound to your 
query to display, update and search your data. 

“Drag-and-drop nirvana.” Nicholas Petreley, InfoWorld 


Give Your Data a Whole New Image. 
Energize your applications by displaying your data in a 
3D chart. The Client/Server Edition gives you more than 
a dozen chart types to choose from, along with over 150 
display options. You also get complete support for run- 
time events so you can bring new drama to your data by 
making your chart interactive. 

“VXREXX is a must buy.” Jacques Surveyer, 
Computer World 


Standard or Client/Server Edition— 

Which one is for you? 

To start creating powerful OS/2 GUI applications right away, 

order your copy of Watcom VX*REXX Standard Edition for just... 


Or, to start creating rich client/server database applications, 
order Watcom VX*REXX Client/Server Edition for just................ 
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1-800-265-4555 - Watcom 


A Powersoft Company 





Watcom Intemational 415 Philip Street, Waterloo, Ontario, Canada N21 3X2 Tel. (519) 886-3700 Fax (519) 747-4971 “Prices and specifications are subject to change without notice. Price does not include freight and taxes where applicable. Prices quoted in US dollars 
' ODGC drivers are available from INTERSOLV, ine. Watcom, the Lightning Device, and VX*Rexm are trademarks of Watcom Intemational Corporation. Other trademarks are properties of their respective owners. OCopyright 1994 Watcom International Corporation 
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mon source code. For objects, IBM 
Open Class and OpenDoc get you to 
common code. Using these tools, you 
can spend your time (and money) de- 
veloping features for your applica- 
tions in order to differentiate you 
from your competitors, wow your 
users, and make yours the applica- 
tions of choice, rather than worrying 
about how to maintain function 
across multiple platforms. 


OTHER QUESTIONS 

One of the other important questions 
that I’ve been asked about the API ex- 
tensions comes from the concern that 
IBM is now lowering the entry point to 
the OS/2 application market for com- 
petitors of those who've supported 
OS/2 from the start. 

While this is an absolutely valid 
concern, several important factors are 
being overlooked. For example, if 
you've been developing for OS/2 all 
along, you've learned all of the tricks, 
have already fallen into the traps of 
multithreaded programming, and you 
know how to debug these types of 
programs. Developers coming from 
the DOS/Win16 world have all this to 
learn. So to start with, your applica- 
tions will be better threaded on either, 
or both, platforms. 

In fact, if you want to get your 
OS/2 application onto Win32, you 
could even do it using these APIs. By 
moving your existing OS/2 code to 
the structure outlined in Figure 1, you 
can get into the Win32 market inex- 
pensively and be the best multi- 
threaded kid on the block. 

IBM’s goal is to provide you, the 
developers, with the tools and vision 
to leverage your investment in code 
while at the same time drive IBM’s 
business. The Developer API Exten- 
sions, combined with IBM Open Class 
and OpenDoc, will give you the pow- 
er and portability to make the most of 
your programming investments. It 
will also give your users the ability to 
choose the platform they prefer and 
choose your applications to run on it. 

You have the tools. How you use 
them is now truly your choice. 


David Reich has been with the IBM OS/2 
development team since 1987. He has worked 
on many parts of the system, supported cus- 
tomers and application developers, and trav- 
eled the world giving seminars and teaching 
OS/2. His latest book is, Designing High 
Performance OS/2 Warp Applications, pub- 
lished by John Wiley and Sons. He can be 
reached on CompuServe at 76711,632 or via 
the Internet at speedracer@bocaraton.ibm.com. 
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Migrating an application to a new platform can be a daunting task for a small software 
company. This time it was worth the gamble. 
By CHARLES DIRCKS 


OS /2 for the PowerPC: 


Fact or Fiction 


_ store from a server (or host). 
| (A different desktop for each 
| group!) 


Figure 1. 0S/2 desktops are centrally administered and delivered to X86 or PowerPC machines. 
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Those of us in the programming 

community often hear about the 

promises of future operating sys- 
tems. If any of us had a dollar for each of 
those unfulfilled promises, our wealth 
would be more than acceptable—although 
still short of Redmond’s most famous citizen. 
Perhaps we should conclude that it is more 
profitable to make promises than to fulfill 
them! 

Still, businesses are based somewhat on 
promises of the future balanced against 
needs of the present. Ours is no different. 
IBM has promised that the API set would be 
consistent for OS/2 whether the hardware is 
an X86 or a PowerPC. Our business needs 
depend on this promise. Our programming, 
we felt, would push the promise to its limits: 
the replacement of the WPObject Class. This 
article discusses our business requirements, 
programming approach, and experience 
with the API set with OS/2 as it applies to 
both the X86 and PowerPC platforms. 


BUSINESS BACKGROUND 


Pinnacle Technology was founded three 
years ago with four primary programming 


log on! 


% 








Your users get their desktops 
wherever and whenever they 


Small file size allows 

~~~ for desktop security and 
delivery to laptops over 
phone lines! 


objectives: make the OS/2 shell “user proof,” 
make OS/2 secure, make OS/2 desktops cen- 
trally manageable, and conserve bandwidth. 

These goals seem somewhat intimidat- 
ing to most programmers until you consider 
that the nucleus of our development team 
was from American Airlines Sabre: one of 
the world’s largest commercial networks. 
Using our tools, system administrators can 
centrally create an ideal (and secure) OS/2 
desktop for a group of users. Whenever and 
wherever they log-on to their LAN, the users 
get their desktop with the appropriate re- 
strictions (such as no desktop pop-up menus 
or no copy or delete rights). 

With increased mobility in the corporate 
marketplace, we architected our file size to 
be very small. For example, the average un- 
compressed size of a desktop is about 20K 
bytes. Compressed, we are less than 2K 
bytes. Therein lies our interest in the 
PowerPC. Within its architecture is a chip 
that offers about twice the speed of the 
Pentium at less than 1 watt:—about the same 
as a hand-held cellular phone. 

The goal is to offer the same secure desk- 
top to a hand-held device as to one that is 
LAN-attached with the same 
file. The user should not care 
whether they are using an Intel 
machine, a Pow-erPC, or a 
hand-held device. 


PROGRAMMING APPROACH 

Our design focused on effi- 
ciency. But paramount to our 
ability to deliver OS/2 desk- 
tops to variable machines is a 
rigorous adherence to OS/2 
APIs and a religious avoid- 
ance of any direct manipula- 
tion of the temperamental! .INI 
files. The .INIs are, by their 
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very nature, machine- and OS/2-version- 
specific. This point becomes important when 
the hardware platform evolves to the 
PowerPC as well. IBM has documented that 
the content and format of these files be 
changed only by the provided APIs. 

The nucleus of our desktop delivery is a 
SOM-based program we call Finder. On an 
OS/2 2.11 machine, Finder is able to quickly 
locate and hide all predefined objects so that 
our other tools can build the appropriate and 
protected desktop. Finder’s class is depen- 
dent on our class replacement of WPO0bject. By 
replacing the WPObject class, we are able to 
carry our own instance data, making it possi- 
ble to extend the object out to the network 
under tight security controls. 

Capabilities on a Warp machine are 
greatly enhanced. Finder can quickly take a 
picture of the ideal desktop that an adminis- 
trator is creating for individuals or groups 
using OS/2 clients and apply various restric- 
tions to each object the user might access. 
This again is accomplished by a sophisti- 
cated object replacement technique that we 
apply to the WPObject class. Given its impor- 
tance to our desktop delivery and security 
products, the Finder is the portion of our 
code that we chose to challenge the portabil- 
ity of our OS/2 application to the PowerPC 
Platform. 

Replacing a class is not for the faint 
hearted, let alone the WPObject class itself. It 
strikes at the core of the operating system’s 
capabilities. We therefore approached the 
project with at least some trepidation. 

The recompile of the Finder went very 
smoothly with no changes to any lines of the 
source code. The Metaware compiler per- 
formed flawlessly in building our complex 
DLLs. Installation was the only setback, 
which was overcome only by repeated at- 
tempts to perform the class replacement. 
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Figure 2. Finder locates all objects on the desktop for administration. 


When we filed the problem resolution re- 
port, it stated that, “Installation was difficult 
due to the operating system being in beta.” 
Let’s call that a famous understatement. 

Once installed, the Finder performed as 
intended with no apparent differences be- 
tween the X86 and Power platforms. Our 
current plan is to provide Finder on the 
forthcoming Sampler CD for the OS/2 Warp 
Connect (PowerPC edition). 


CONCLUSION 

All companies need to conserve resources— 
some more than others. Still, we were more 
than curious to evaluate the effort to port our 
applications to the PowerPC. We asked our- 
selves what the historical costs were associ- 
ated with porting existing applications to 
other platforms (DOS to UNIX, Macintosh to 
Windows, or VM to CICS). In every case, 
only the largest companies have been able to 
bear the development costs of such an effort. 
Smaller firms do not even make the attempt. 
Our answer to the question, “Can we handle 
the cost of porting to the PowerPC?” is a re- 
sounding “Yes!” 


Charles Dircks is the chief security architect of 
Pinnacle Technology based in Indianapolis, In. After 
graduating from Indiana University with a degree in 
computer science in 1981, Charles has had an exten- 
sive career in developing bandwidth-sensitive applica- 
tions, which included over 10 years at American Airline 
Sabre. Charles was recently a featured speaker at 
IBM's Technical Interchange. 
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A young, bleeding-edge software company migrates a bulletin board system to OS/2 for ‘a 


the PowerPC. 
By STEVEN TOWER and JOHN MORRIS 


Porting to the PowerPC 


Editor's note: AdeptSoft is one of those 
brave companies that signed up for IBM's OS/2 
for PowerPC beta program. Since many of our 
readers are contemplating the development or mi- 
gration of applications to this new platform, we 
asked AdeptSoft’s pioneers to share their experi- 
ence with us. 


n the road to IBM’s OS/2 for the 
PowerPC, we expected a bumpy 
ride with lots of twists and turns, 
but instead we found the Autobahn. 
IBM promised that OS/2 for the PowerPC 
would be a painless move from the OS/2 
Intel platform as long as we met one main 
criteria: the application had to be a pure 32- 
bit OS/2 application, or using as few 16-bit 
calls as possible. 





LOOKING AHEAD 

About three years ago, AdeptXBBS started as 
a 16-bit OS/2 PM application. In a bold 
move, we made the decision to rewrite our 
application from the ground up for the new 
32-bit OS/2 with its Workplace Shell. This 
was a fairly drastic step. One of us had expe- 
rience ported 16-bit DOS applications to 32- 
bit OS/2. It was actually easier to do this be- 
cause the DOS applications didn’t have any 
16-bit OS/2 API calls in them. Quite a bit of 
the OS/2 API had changed, either through 
the use of LONGs instead of SHORTs, or the 
more intuitive API naming scheme. Not to 
mention that some API calls had been 
dropped in favor of improved ones. At the 
time, the changes needed to make the pro- 
gram fully 32-bit left a bitter taste in our 
mouths. But it was one of the best moves we 
made in our development process. Once the 
conversion was complete, things were once 
again looking up. 

Being relatively familiar with IBM’s 
Workplace OS/Microkernel strategy, and 
with some guidance from insiders at IBM, 
we kept on top of the design of Workplace 
OS/2 (now OS/2 Warp Connect [PowerPC 
edition]), following every move and making 
sure that we didn’t use any unsupported 
APIs. 

One major decision, as part of our plan 
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to make sure our application would run well 
and be able to follow IBM’s operating system 
strategy, was to make sure that potentially 
nonportable code was put into a .DLL. By 
placing 16-bit and other nonportable calls 
into a .DLL, we reduced our porting time 
extensively. 

Over the last three years, development 
of AdeptXBBS continued at a blinding pace. 
In December, we received confirmation that 
we were in the IBM PowerPC beta program 
and would have our chance to prove that 
everything we had done was going to work. 


OUR FIRST POWERPC COMPILE 

IBM made it clear that if we had a pure 32- 
bit application, porting would be a simple, 
undaunting job. We still expected problems. 
The first beta (alpha?) release of the operat- 
ing system and the accompanying compiler 
were, shall we say, interesting. We decided 
to start by porting the hardest part of our 
product, the two .DLLs, with 16-bit calls. We 
figured that if we could get those two .DLLs 
to work, the rest would be a breeze. After a 
few days, we made our first test run. It didn’t 
work. The operating system returned bizarre 
return codes that even some of OS/2’s devel- 
opers couldn’t explain. 





Figure 1. How little things can come back to “haunt” you. 
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At this point we decided to wait 
| for beta #2 and just clean up the rest of 
our application code in preparation for 
the big port. Our application, a 32-bit 
PM BBS program, was still compiling 
with several warnings whenever we 
did a full compile. We decided to 
make sure our product would compile 
with absolutely 0 warnings and 0 er- 
rors. 


FROM WATCOM TO IBM TO METAWARE 

For two developers with over 150,000 
lines of code sitting in front of them, 
this was no easy task. We started com- 
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Utilities 

e Screen Image 
Print/Capture 


e Clipboard 
Import/Export 


e Screen Saver 


e Date & Time 
Display 


piling with Watcom’s C v. 10.0. Once 
we had all of the .EXEs and .DLLs 
compiling with 0 warnings and errors 
under Watcom’s C compiler, our next 
step was to get the same results with 
Watcom’s C++ compiler. While doing 
this, several major problems appeared 
and were corrected. Next, we com- 
piled on IBM’s CSet and CSet++ until 
the same 0 warnings and errors were 
achieved. We completed the process 
with Metaware’s C++ compiler. We 
learned that by taking the time to do 
something that seemed trivial at the 
start, in the end we had a application 
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that was not only able to compile flaw- 
lessly under three compilers, it was 
also faster, smaller, used less memory, 
and was more stable! 


WHO MAKES THE HIGHC 
COMPILER, METAWARE? 
The compiler found on the IBM 
DevCon CD ROM was used for the 
final porting process. This compiler 
did not appear to build a functional 
executable file, but we were able to use 
it to get an understanding of how the 
rlignt compiler differed from Wat- 
com’s C or IBM’s CSet++. The first 
thing that we discovered was that we 
didn’t need to make any changes to 
our OS/2 API calls (Yeah!!!). Next, we 
discovered major differences in com- 
piler syntax between the Watcom com- 
piler and the HighC compiler. This is 
where 95% of the port occurred. 


NEW COMPILER SWITCHES 

As with most compilers, HighC has it’s 
own unique compiler switches. Learn- 
ing these new switches is the first step 
to porting your application to the new 
PowerPC machine. 


TYPE CHECKING 

HighC has much stricter type check- 
ing. Get used to it. You may not like all 
of the compiler warnings, or errors, 
but after correcting these problems 
you will have a more robust applica- 
tion. Figure 1 shows how little things 
can come back haunt you. 


MEMORY ALLOCATION 

Make sure you cast all of your memory 
allocation calls! We had properly cast 
about 85% of ours, but the last 15% 
was what got us. Our application is 
heavily multithreaded, so we make 
several calls to the well-known _be- 
ginthread() function. The HighC version 
differs from the call that most of us 
have gotten used to in that it has only 
three parameters, The pointer to a pre- 
viously allocated stack buffer is not 
present. This differs from the Watcom 
and IBM calls, which take four para- 
meters rather than three. The four-pa- 
rameter calling convention is a leftover 
from the 16-bit days and was appar- 
ently kept the same, so you wouldn't 
have to change this call if you were 
changing platforms. Since we have _be- 
ginthread() calls in several different lo- 
cations, we decided to just write a 
macro and put it in one of our header 
files. That took care of the _be- 
ginthread() problem. 

be= 


#define _beginthread(w,x,y,z) 


ginthread(w,y,z) 


We make heavy use of the vari- 
able _threadid as an easy way to deter- 
mine the current thread ID. Watcom C 
defines this as: 


extern int *__threadid(void); 
#define _threadid (__threadid()) 


Our code would say something like: 
printf("I am thread #/d\n", *_threadid()); 


Under HighC, this failed miserably. It 
is defined as: 


extern int _threadid; 


In this situation, it is best to make a 
separate function, which contains 
#ifdefs and compiler specific code, like 
this: 


int ThreadID(void) 
{ 
fifdef __HIGHC__ 

return(_threadid); 
Helse 

return(#_threadid) ; 
#endif 
} 

printf("I am thread #/d\n", ThreadID()); 


Because HighC seems to primarily 


a C++ compiler, it also is missing the 
min() and max() macros. To be safe, 
make your own min() and max() func- 
tions: 


#ifndef MAX 
#define MAX(a,b) 
((b)) 


(((a) > (b)) 7? (a) : 


#endif 

#ifndef MIN 
#define MIN(a,b) 
((b)) 

#endif 


(((a) < (b)) ? (a) : 


FINALLY, OS/2 FOR THE POWERPC! 

Finally Beta #2 of OS/2 for the 
PowerPC came out. We were excited. 
After installing the new build of the 
operating system we immediately 
went to work on our video system: a 
16-bit .DLL requiring the most work. 
Since we already had a 32-bit version 
of this .DLL (that took about a day to 
convert), it just was a matter of recom- 
piling under the new version of the 
compiler, writing a test program, and 
moving the files to the PowerPC. It 
was a success! The .DLL worked just 
as well as its 16-bit cousin. With this 
first success we were energized. We 
immediately went to work compiling 


the other .DLLs directly from the origi- 
nal Intel-based source code. Once 
again, success after success after suc- 
cess! In about eight hours, we had 
managed to compile all of our .DLLs 
and our main .EXE’s for the PowerPC. 
Of course the big question still was, 
“Would it work?” 

Our software makes use of every- 
thing that is OS/2. We make extensive 
use of multithreading and sema- 
phores. We even wrote our own open, 
read, write, and close functions to by- 
pass the compilers and use nothing but 
32-bit calls. We were sure that we 
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would find something that didn’t 
work. 


THE BIG MOMENT 

Moving four megabytes of files to the 
PowerPC was easy. IBM has a basic 
TCP/IP stack that allowed us to use 
TFTP to move the files. Now the time 
had come for us to actually run our 
software. We typed Adept.Exe at the 
command prompt. Nothing. The screen 
blinked, the operating system returned 
an ambiguous return code, and we 
were back at the command prompt. 
Since we were not able to get the de- 
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bugger to work, we were dead and 
blind. Resorting to DosBeep, we fol- 
lowed the execution line of the code 
only to realize that we were missing a 
-DLL. Digging through our backups, 
we found the source, recompiled and 
moved the .DLL over to the PowerPC. 
Once again, at the command prompt: 


[C:\ADEPT\] Adept.Exe [ENTER] 


The screen blinked. We assumed, 
“Oh no, here we go again!” But no. A 
PM window was drawing on the 
screen—slowly—but it was drawing. 
After about 45 seconds, we were star- 
ing at our BBS software running on an 
IBM PowerPC! It worked! 

IBM had done it, we had done it! 

We played with the program to 
see if everything was working prop- 
erly. Amazingly, everything worked 
and ran flawlessly. In just 12 hours we 
were up and running with no prob- 
lems on IBM’s OS/2 for the PowerPC. 

IBM wasn’t kidding. When they 
originally promised that Workplace 
OS would have the same 32-bit API as 
OS/2 2.0 we may have all turned 
around and snickered a little bit, but 
with OS/2 for the PowerPC they really 
came through. 
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A veteran 0S/2 application developer makes the trek from Intel to PowerPC. His results 
may surprise you. 
By RANDELL S. FLINT 


Getting There From 
Here: Moving to the 


PowerPC 


ow that OS/2 Warp Connect 
(PowerPC edition) is almost 
here, and you've heard about 
all the companies that are moving their 
applications over to this powerful new 
hardware platform, you've decided to 
move yours as well. There’s no doubt 
that you’ve got an interesting task 
ahead. 

The great news, however, is that 
you're almost done already, provided 
you have a (pure) 32-bit native OS/2 
application. 

Of course the process is much more 
complex if you have a 16-bit applica- 
tion, or one that isn’t OS/2 native. To 
get to the PowerPC from there, the first 
(and by far, biggest) step is in getting to 
32-bit native mode running on regular 
old OS/2 on an Intel-based system. But, 
that’s not the focus of this article. 

What we’re concentrating on is 
what you can expect in moving that ap- 
plication from the Intel-based OS/2 
world over to the new PowerPC-based 
OS/2 environment. At Sundial Systems, 
we've been working with OS/2 for 
PowerPC for over seven months, In that 
time, we've “moved” virtually all of the 
code for our Relish® time and informa- 
tion organizer products over to the 
PowerPC. What we presently have up 
and running is essentially a complete 
version of the single-user product, 
Relish 2.2. It looks, feels, and (for the 
most part) acts just like the commercial 
(Intel) version sold today. 

We've settled on the term “moved” 
to describe what we’ve done for good 
reason. Bringing a native OS/2 program 
onto the PowerPC isn’t a porting 
process (like between operating sys- 
tems) or even a conversion process 
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(which often describes the process of 
going from a 16-bit to 32-bit implemen- 
tation). It’s something much simpler! 
It’s very close to a recompile, relink, 
and go process. And getting closer 
every day as the operating system and 
tools reach their final release date. 

Things are a little rough today in 
those places where the OS/2 for 
PowerPC beta code hasn’t completely 
settled down yet. (This discussion cen- 
ters around what is known as Beta II 
from April; a later beta should be avail- 
able before you read this article.) For in- 
stance, in the Beta II version, there’s a 
quirky little bug in the allocation of 
shared memory, which means two 
Relish operations—dragging a note to 
reschedule and double-clicking on a 
note to revise—fail randomly about 20% 
of the time. 

And there’s another weird problem 
shared by Relish, the System Editor, and 
a few other applications: the keyboard 
and mouse button state information 
messed up whenever the application 
first gets focus. 

There are a few other similar prob- 
lems and a bunch of little nit-picky 
ones. But all in all, even with these beta 
underpinnings, OS/2 for PowerPC has 
shown itself to share OS/2’s heritage of 
a stable environment on which to build 
and deploy robust applications. Our lat- 
est prerelease of “Power Relish” is at 
least as stable and snappy as what some 
companies (mostly on other platforms) 
might be tempted to sell as a 1.0 prod- 
uct in the retail marketplace. 

In the process of getting to this 
point, we have made some changes to 
the code. Most are workarounds for 
current problems in a particular build 
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of OS/2 for PowerPC . A few are 
permanent changes to the code 
that replace an Intel-specific con- 
struct with one that works equally 
well on Intel and the PowerPC. 

The actual number of code 
changes is incredibly small, how- 
ever. Over the course of the past 
few months, the total number of 
changed lines of code has been 
down to as little as five—out of 
over 250,000! At the moment, that 
number is a little higher, as a re- 
sult of working around some Beta 
II problems to produce a version 
that is stable and complete enough 
to distribute to our beta test cus- 
tomers. Even at its highest point, 
however, the number of changes 
was almost two orders of magni- 
tude less than the number we 
needed to go from 16-bit to 32-bit 
OS/2 several years ago. 

To put it in a nutshell, we 
don’t expect to do much more 
work on Power Relish before it 
ships. What we will do primarily 
involves “undoing” some of the 
things we've done already and 
performing extensive final testing. 
That “undoing” really amounts to 
the removal of the workaround 
code in the current (prerelease) 
version once there is a later OS/2 
for PowerPC version that fixes 
some of the problems mentioned 
above. There’s an excellent chance 
we will be ready to ship before 
OS/2 for PowerPC becomes gen- 
erally available. 

And things are only getting 
better. Many of the early problems 
with the development tools have 
disappeared. Other improvements 
have been made so that you no 
longer need to know many of the 
special compiler flags or idiosyn- 
crasies of the linking process. It 
now seems quite likely that, had 
we started today rather than with 
the prebeta environment of last 
November, it would have taken 
only a couple of days, and certainly 
less than a week, to get Relish that 
far down the PowerPC path. 

The main reason why this 
whole process is so simple is that 
we are talking about OS/2. 
Whether it’s running on Intel 
hardware or PowerPC hardware, 
the point is that it is OS/2. In the 
future, it will be “OS/2 and 
more,” as the operating system 
(and the applications running on 
it) take further advantage of the 
PowerPC hardware. 
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Much of IBM’s code that im- 
plements OS/2 as we know it 
today is the same on both Intel 
and the PowerPC. For instance, 
there are very few changes (and, 
possibly by now, none at all) in 
the code that implements the 
Workplace Shell. The differences, 
today, are in the “lower” parts of 
the system: the PowerPC version 
is based on IBM’s microkernel, 
and sitting on top of that, a new 
OS/2 Server that implements all of 
the OS/2 calls (principally, the 
Dos* calls) in a way that is com- 
patible with the existing Intel 
implementation. 

Eventually, there will be even 
less of a difference. There will be 
one version of the entire OS/2 
source code tree—one based on 
the Microkernel and OS/2 
Server—that can be targeted to- 
ward either Intel or PowerPC 
hardware when it is built. 

Today, applications can al- 
ready be built that same way— 
with one set of source code, tar- 
geted for either Intel or PowerPC 
at build time. That’s how we are 
building Relish. If you have trou- 
ble believing this, let me relay a 
story which you may have already 
heard about elsewhere since it is 
so remarkable. 

The folks at the Desktop 
Company have an OS/2 product 
called XFolder. This is an exten- 
sion to the Workplace Shell that 
supports all sorts of new arrange- 
ment and undo options for desk- 
top folders. It’s extremely useful 
for keeping your icons neatly or- 
ganized. At some point in May, 
the company decided that it 
wanted to see if it could get 
XFolder up and running on OS/2 
for PowerPC—the IBM Technical 
Interchange was coming up and 
Desktop really wanted to show 
both versions. 

There was one little problem, 
though. The Desktop Company 
wasn’t part of IBM’s Beta program 
so it didn’t have a PowerPC or a 
copy of OS/2 for PowerPC . It did 
have, however, the Beta toolkit off 
the Developer Connection CD 
(discussed later). The company 
tried to get XFolder compiled and 
linked, but ran into (what ap- 
peared to be) a compiler problem. 
So, when the people from Desktop 
Co. got to the Technical Inter- 
change, they hooked up with the 
folks from MetaWare (who sup- 
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plied the compiler) and got the 

issue resolved. (It turned out to be 

a mistaken use of a compiler 

switch.) Once they had a clean 

compile and link, they brought 

XFolder up on a PowerPC that 

MetaWare had at the show. 

Now this wasn’t a truckload of 
code (only about 25,000 lines or so), 
but it wasn’t simple code either. 
What we are talking about is a 
Workplace Shell replacement class, 
the corresponding objects, and a 
fair amount of user interface code 
to drive the thing. And it worked, 
for the most part, the first time out! 
The best part of the story is that the 
total development time involved 
was only about five hours. 

This brings us to a brief dis- 
cussion regarding how you are 
going to build your OS/2 for 
PowerPC application. 

Today, the basic strategy for 
actually building a PowerPC ap- 
plication is to build it on your 
Intel-based OS/2 system. While at 
some point in the future you will 
be able to build it on the PowerPC 
itself, using your Intel-based sys- 
tem today makes sense. That’s be- 
cause OS/2 is a stable, robust de- 
velopment environment. So, since 
many developers already use it as 
a host environment for developing 
non-OS/2 applications, why not 
use it to develop PowerPC appli- 
cations as well? 

This Intel-hosted tools ap- 
proach has the added advantage 
of allowing development to pro- 
ceed at a faster pace than would 
otherwise be possible. And that’s 
because you can develop an OS/2 
for PowerPC application com- 
pletely without even having a 
PowerPC (or PowerPC version of 
Warp). 

While it has gone almost un- 
noticed by many developers, all 
the tools necessary to build an 
OS/2 for PowerPC application 
have been appearing on IBM's 
Developer Connection (DEVCON) 
CD since Volume 6 in early 1995. 
Here’s a brief overview of what 
you'll find: 

e A version of MetaWare’s High 
C/C++ Compiler for OS/2. This 
is essentially the same compiler 
that you can buy to build OS/2 
for Intel applications, but this 
one has been modified to gener- 
ate PowerPC object modules 
rather than Intel object modules. 
In fact, this is the compiler that 


was used by IBM to build much 
of the Beta versions of OS/2 for 
PowerPC itself. (For those of 
you who just can’t part with the 
idea of using IBM’s CSet++ 
compiler, an Intel-hosted Pow- 
erPC version is also expected to 
be available soon.) 
A replacement linker (also sup- 
plied by MetaWare) that gener- 
ates PowerPC executables. 
These are in a new format 
specifically designed for the 
PowerPC. 
Replacements for many of the 
supporting tools. MultiRes 
(MRES ) replaces RC, MultiLib 
(MLIB) replaces LIB and IM- 
PLIB, and the Universal 
Resource Editor replaces the 
Dialog Editor, for example. In 
general, these new tools are de- 
signed for cross-platform use— 
they aren’t PowerPC- or Intel- 
specific like the tools they 
replace. 
¢ A special version of IPMD that 
allows you to debug your 
PowerPC application over a 
TCP/IP-based LAN (but for 
that, of course, you need a 
PowerPC and you “need” bugs 
that need debugging). 

In all likelihood, your Power- 
PC application won't have any 
bugs! I can hear you saying, “This 
guy has lost his mind! All new ap- 
plications have bugs.” Yes, it’s true 
that newly programmed code al- 
most inevitably has bugs. But 
you're not dealing with new code 
here. 

If you have a working, de- 
bugged, native, 32-bit application 
running on OS/2 today, then once 
you get it recompiled and relinked 
into a PowerPC executable, it’s 
quite possible you won’t have any 
bugs to debug. And if you do, it’s 
just as likely to be related to some 
quirk i in OS/2 as it is to a quirk in 
your own code. 

What follows are some prob- 
lems that I’ve run into during my 
trip through the process. 


DOS* CALLS 

Because most of the Dos* calls in 
OS/2 for PowerPC have been re- 
implemented by the OS/2 Server 
and the Microkernel, this is the 
least “seasoned” part of the sys- 
tem. In a sense, this is the part of 
the system that will be the most 
1.0-like when it ships. It’s the most 
likely part to have a few bugs or to 


at least operate a little differently 
than the present Intel version. It’s 
also possible that some of the pa- 
rameter validation on these calls 
will end up being different. 

For instance, Relish happens 
to use the DosQueryCurrentDirectory 
call in one of those less than com- 
mon ways. What it does is pass 0 
for the size of the buffer that will 
be filled with the directory name. 
What OS/2 is supposed to do is re- 
turn an error code (ERROR_BUFFER_OVER- 
FLOW) together with the size of the 
necessary buffer. Well, in the ini- 
tial re-implementation of the Dos* 


calls, that didn’t work, and the ini- 
tial testing of the re-implemented 
APIs didn’t catch it. While the 
problem has since been corrected, 
it seems likely that a few of the 
more obscure corners of the Dos* 
calls may end up working not 
quite the same until your code 
happens to find the difference. 


THE NEW 32-BIT PORTABLE TOOLS 

Some of the tools you’ve com- 
monly used to build your applica- 
tions are being replaced by new, 
more portable versions. In the 
process, the new tools are often 
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supporting 32-bit constructs in 
place of older, 16-bit ones. For ex- 
ample, while resource identifiers 
used with RC have always been re- 
stricted to 16-bit values, MRES 
does its internal computations in 
32-bit form. Thus, if you used 
tricks with RC (like using -1 in- 
stead of 65535 as we did in a few 
places for historical reasons), you'll 
need to make changes because the 
values won’t come out the same 
with MRES. 


CODE CHECKS 

MADE BY THE COMPILER 

Whenever you change compilers 
(or, for that matter, compiler ver- 
sions), you may also find that your 
source code gets treated just a bit 
differently than had been before. 
Some compilers are tighter about 
older or nonstandard code struc- 
tures than others. And some just 
have different interpretations of 
what is good and what is not, es- 
pecially in areas beyond the 
bounds of the language standard. 
This isn’t a case where one com- 
piler is necessarily better than the 
other—they are just “different” in 
their approach to your code. 
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For instance, the MetaWare 
compiler caught a couple of places 
in some of our header files where 
there was a blank after the \ at the 
end of a line in what was sup- 
posed to be a continuation of a 
macro definition. What the com- 
piler did to that poor macro defini- 
tion wasn’t a pretty sight—but it 
was right—the blank shouldn’t 
have been there. CSet++ was just 
being overly kind to the definition 
in letting it through. 


NON-ANSI C EXTENSIONS 

While it’s generally desirable to 
stay within the bounds of ANSI 
standard C, sometimes there is 
good reason to stray a bit. Adding 
threads to your program is a good 
example. If you try to do that 
within ANSI-standard C, it means 
using operating system calls (such 
as DosCreateThread) to control the 
threads. Once you take this ap- 
proach, however, you can’t use a 
large number of your favorite C li- 
brary calls because either the li- 
braries aren’t thread-safe or they 
require some sort of (non-ANSI) 
setup on a per-thread basis. So, the 
usual solution is to use nonstan- 


dard library calls (such as _be- 
ginthread) rather than operating 
system calls for thread control. 
That's fine so long as the library 
calls are supported in the same 
way by the different compilers 
that you might use. But since, by 
definition, these calls aren’t stan- 
dard, they might be different, or 
treated differently, and that’s defi- 
nitely something you need to 
check. 

A perfect example is _be- 
ginthread. Even though it’s part of 
both the CSet++ and MetaWare li- 
braries, the parameters to the call 
aren't quite the same. The CSet++ 
version takes four parameters, and 
MetaWare version takes three. 
Ironically, the parameters are the 
same except that CSet++ expects 
that its extra one (in the second 
position) be NULL! (For those of you 
who might not be familiar with it, 
CSet++ takes this extra parameter 
for historical reasons, which are 
related to how threads were han- 
dled on OS/2 1.x.) 


THE TOOLS ARE STILL EVOLVING 


Most compilers don’t include all 
the non-ANSI part of their header 


DCF/2 Lite... The “on the fly” data compression package for OS/2. Use the DCF/2 to create 
multiple, HPFS-formatted virtual disks on top of your existing FAT or HPPS formatted 
partitions, network drives- even floppies! DCF/2 is on-line backup without an expensive tape 
unit or individually archived files. 


*The Graham Utilities... The most comprehensive suite of disk, file and general utilities 

“| specially designed for OS/2. Combined with networking options, HPFS utilities and system 

! diagnostics, The Graham Utilities provide all OS/2 users with invaluable support. This 

Limited Edition specifically created for the Productivity Pack offers 15 powerful functions of 
the 52 invaluable applications and modules that are available in the full version. 


Relish v.2.12...Winner of 1994 OS/2 Magazine's Editor's Choice Award! Flexible 
scheduling functions combine with the Workplace Shell drag-and-drop environment for ease 
and convenience. Relish's intuitive approach to personal calendaring is grounded in a multi- 
tasking, multi-threaded design. Combine that with drag-and-drop enhancements, time- 
saving features, and extensive flexibility to manage time and tasks with ease. 


DeskMan/2 v.1.51b...THE premier solution to manage and 
enhance the OS/2 environment. This best selling package allows 
users to install, configure, backup, secure and manage desktops 
and objects locally and remotely, The VUEMan/2 component 
brings new meaning to "multi-tasking", enabling users to create as 
many as 81 virtual desktops. A simple drag-and-drop, point-and- 
click interface makes DeskMan/2 easy to use for novice OS/2 
users, while its API and full CID enablement provide powerful 
command and control of the OS/2 operating environment for 
corporate administrators. DeskMan/2 v.1.51b includes features 
that were previously available only in the Corporate Edition such 
as password protection of objects, and Workplace Shell audit trails. 


FREE* Upgrade to DeskMan/2 v.2.0 when available! 


*CPU Monitor Plus, Special Edition...The powerful tool to manage your OS/2 
computer! CPU Monitor Plus is your complete package of advanced performance and 
analysis tools, all integrated into one powerful solution. Use CPU Monitor Plus to 
continuously monitor and display CPU, RAM, Disk, COM port activity, as well as 
dynamically monitor and control your OS/2 programs! Let the powerful analysis engine rip 
through raw system data and give you graphs or text, percentages, ratios, bytes or seconds. 


PLUS Upgrade coupons for each of the above power apps are enclosed! 


| *Special editions developed exclusively for the Productivity Pack. 


"plus shipping and handling 


DeskMan!? dramatically improves the ability of 
corporations and weers fo get the most out of 
Os /2 Deskiian)2 helps administrators restrict 
and control whal wsers are doing and provides 
robusl backup/resfore features and seamlessly 
enhances the features of ihe WPS 
Dr Mike Kogan: Lead Architect of OS/2 2.0 
Author: The Design of O5/2 
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files, nor do they automatically in- 
clude non-ANSI libraries when 
used for linking. Usually, you in- 
clude something in the compile 
options to tell the compiler that’s 
what you want to do. While the 
MetaWare compiler includes many 
non-ANSI calls by default, that’s 
not true for thread-related calls 
like _beginthread. 

In the early versions of the 
MetaWare PowerPC compiler, you 
did this by defining __MULTI__ on 
the command line and changing 
your link options to reference the 
multithreaded library (hct.lib) ra- 
ther than the normal one (hc.lib). 
By the time Beta II arrived, this 
had been simplified through the 
use of the -thread compile option, 
which took care of both the header 
file and library issues. 


AVOID MAKING ASSUMPTIONS 

There are other non-ANSI issues 
that need to be dealt with in a sim- 
ilar way, one of which is SOM 
support. If you happen to use this 
in your code, you might think you 
should use the -som option in the 
same way you use the -thread op- 
tion. Well, that’s not quite right, 


because when compiling, this turns 
on MetaWare’s support for Direct- 
To-SOM code generation, which is 
probably not what you want in 
this case. However, you probably 
do want the -som option when link- 
ing, since this will cause any neces- 
sary SOM libraries to be linked in. 


LIBRARIES YOU NEED 

MAY NOT BE AVAILABLE 

One particularly vexing problem 
in these early stages of movement 
to the PowerPC is the availability 
of any third-party libraries that 
you might need as part of your 
application. 

The good news is that libraries 
move over just as easily as appli- 
cations do. The bad news is that 
you need the source code to do it 
(or you have to have the owners of 
the source code do it). In Relish, 
we do use one third-party library. 
Fortunately, we do license the 
source code and have moved it 
over using the same process as our 
own source. 


SOME DIFFERENCES IN THE 
UNDERLYING IMPLEMENTATIONS 
And, finally, once you do get the 
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code compiled, linked, and run- 
ning on the PowerPC you may 
still notice some minor differences 
that shouldn’t (but might) make a 
difference. That’s because parts of 
the operating system are indeed 
different. 

In Relish, we happened to no- 
tice this in the case of critical sec- 
tions. While it’s probably not no- 
ticeable to the user, we discovered 
that entering and exiting critical 
sections is a little more costly on the 
PowerPC than it is on the Intel ver- 
sion of OS/2. Sources tell us that 
it’s true, and the reason has to do 
with how the OS/2 Server inter- 
faces with the Microkernel to im- 
plement (jointly) the DosEnterCritSec 
and DosExitCritSec calls. Likewise, 
there are other calls which seem a 
little faster on the PowerPC, 
though this may have as much to 
do with the processor as anything 
else. 

So if you’ve got any really 
tight timing dependencies, partic- 
ularly among multiple threads, 
you might want to test that code a 
little extra carefully. 

Another area of major differ- 
ences is in the device drivers. IBM 
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hasn't publicly said so, but it ap- 
pears that much (if not all) of the 
device driver code is brand new 
in the PowerPC version. In part, 
that’s to be expected, since the 
low-level hardware architecture of 
the systems is indeed different. 
While the various OS/2 APIs hide 
most of these issues, some of the 
differences will no doubt surface 
through them. In particular, appli- 
cations that deal intimately with 
devices (such as communications 
programs) would appear to re- 
quire particular scrutiny in their 
use of these APIs. 
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CONCLUSION 
All in all, it’s fairly easy to move 
your application onto OS/2 for 
PowerPC. Start with your 32-bit 
native OS/2 application, keeping 
in mind that OS/2 for PowerPC 
and the tools you need are still 
beta in nature; and, don’t be sur- 
prised by the inevitable quirks 
that might put bumps in your 
path. Then, head out on this pow- 
erful new hardware platform. 
You'll likely enjoy this trip much 
more than porting or conversion 
efforts you've been on in the past. 
And, if you'd like to get a feel 
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of just how close things can get, 
we'll be happy to send you 
Working Model (demo version) 
copies of Relish for both Intel and 
PowerPC, That way you can re- 
ally compare and see for yourself. 

You can download beth ver- 
sions from a variety of sources (in- 
cluding the Sundial-Systems sup- 
port section in the OS2AVEN 
forum on CompuServe). Or, if you 
prefer, we’ll send you copies on 
diskette. For the latest availability 
information, just drop us a note 
via the Internet to relish@ibm.net. 


Randell S. Flint /s president of Sundial 
Systems Corp. As the chief architect of Relish, 
he's been deeply involved with OS/2 since 
Version 1.0. His earlier article on the client- 
server architecture of Relish appeared in the 
Spring 1991 issue of OS/2 Developer. He can 
be reached via the Internet at rflint@ibm.net or 
at Sundial Systems Corp., 909 Electric Ave., 
Suite 204, Seal Beach, CA 90740. 





In the fall, the bugling of the elk can 
be heard echoing through the Colorado 
high country. Trumpeting both challenge 
and accomplishment, these magnificent 
| animals gather every fall to form groups 
for the year ahead. Solitary for much of 
the year, and social for the rest, they rely 
—J on each other without compromising their 
maverick nature 

Programmers committed to OS/2 
gather in the Colorado high country at the 
QQS same time of year, for similar reasons: to | 

gain strength and wisdom from their 
peers, while drawing inspiration from the 
ever-increasing numbers of those peers. 

Colarad$/2 is renowned throughout | 
the world for the quality of its technical 
content, but that is only part of its appeal. 
The rest is. the friends and contacts you 
make here. Isn't it time you were part of 
this unforgettable experience? 


Plan now to 
attend the Fourth 
International 
ColoradOS/2 
1! 
To register or for information call: | 
(800) 481-3389 US & Canada 


(719) 481-3389 International 
(719) 481-8069 FAX 
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| A special issue by the publishers of OS/2 Developer 
| Easy-to-learn. .. fast... interactive. .. » E-Mail Enabling REXX 
; whether you're considering using = Introduction to Workplace 
: REXX for the first time—or a REXX — Shell Programming Using REXX 
g | developer who wants to maximize this = Combining REXX with 
: {| IBM-endorsed language—you'll find PostScript 
the tips and techniques you need in | . 
the REXX Report " PDS Transfers Using EHLLAPI 
in REXX 
Quantities are limited. Order now! The 2nd edition of the REXX Report = and more, including a Buyer's 
For fastest service, fax the completed has all newly commissioned articles Guide to REXX language 
order form below to (708) 647-5972. by REXX-perts in the field. For only products, interpreters, 
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An OS/2 software developer meets airline industry requirements with a low-cost. 
client-/server-based reservation system. 


By JIM MONROE 


Building an 
OS/2-Based Airline 
Keservation System 


ince the advent of the PC, software 

designers have been faced with 

many choices: operating systems, 
database engines, programming languages, 
and other application requirements. This arti- 
cle is about the approach taken and some de- 
cisions made in the development of an all- 
new, client-/server-based airline reservation 
system. This development approach may pro- 
vide some help when, and if, you are faced 
with a similar predicament. 


BACKGROUND 

Prior to embarkation into the airline industry, 
many months were spent analyzing the in- 
dustry and the application offerings available. 
The findings were that the industry is ex- 
tremely narrow and, to survive, any products 
offered would have to be inexpensive and use 
the best technology available. 


SETTING SOME GOALS 

An airline reservation system was produced 

that was scalable to serve the needs of a very 

small budget airline all the way up to the size 

of currently available large reservation sys- 

tems. The system would be priced 50% lower 

than competitive systems and would still earn 

a profit. 

The design criteria consisted of the fol- 

lowing elements: 

¢ It would be scalable from a single PC to an 
IBM 370/390 system 

* It would use an “Open Architecture” 

e All data would be available from a rela- 
tional database 

* The operating system would support mul- 
titasking and multiple users 

* A response time of less than two seconds 
would be maintained at all times 

e Networking would be easy to install, main- 
tain, use, and include the ability to connect 
via the Internet 


e It would be accessible from any terminal 
type, internal or external to the enterprise 

¢ The system would be easy to use and re- 
quire little or no training. 
A descriptive name was selected that 
would also convey simplicity: The Airline 
Reservation System (TARS). With TARS, sev- 
eral potential customer groups are addressed: 
¢ Start-up airlines with a choice of terminal 
types and physical placement because they 
have nothing installed—no heritage 

e Airlines that have already migrated their 
reservation center, airport counters, and 
agents to PCs because they have been 
migrating to LAN-based distributed 
processing 

e Airlines that have not migrated (or have 
been delayed) to a PC “terminal” strategy 
because their installed base or wiring im- 
paired migration 

e Airlines that are “renting” services, which 
preclude flexibility or ultimate use of na- 
tive PC technology because someone else is 
dictating the connectivity alternatives 

e Airlines with significant investment into 
wiring that cannot be easily accommodated 
into certain terminal connectivity because 
they have stayed with the early VT termi- 
nal clusters. 


SEEKING A MULTI-USER, MULTITASKING, 
MULTI-PLATFORM SOLUTION 

To provide needed scalability, the architec- 
ture was designed as a distributed application 
within a client/server environment. This 
would allow the relational database to reside 
on either the server or on a client system. 
After reviewing several database engines that 
met this requirement, IBM’s DB2 became the 
logical choice. One reason was because this 
engine could be used on OS/2, AIX/UNIX, 
OS/400, MVS, VSE, VM, Sun Solaris, or HP- 
UX. This covered all possible system combi- 
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nations, allowing TARS to be operating sys- 
tem- and hardware-independent. 

C was chosen as the programming lan- 
guage because it also supported all operating 
system and hardware platforms. Also, C pro- 
grammers are available and the language is 
not manufacturer dependent. 


0S/2 WARP—ON SERVERS AND CLIENTS 

At the low- to mid-range level, OS/2 Warp 
was used for both server and client. By in- 
stalling DB/2 on this platform, the smallest 
configuration fits on a single personal com- 
puter. By propagating DB/2 to larger or mul- 
tiple-user platforms, and keeping the client 
portion on OS/2, the system can grow to any 
size needed. This also included the ability to 
attach any nonintelligent terminal directly via 
RS232, over TCP/IP or the Internet. 

When examining various networking re- 
quirements, it was found that the IBM LAN 
support (LAN Server version 2.X and later) 
addressed the traditional client/server re- 
quirements, as well as wide-area networks 
(WAN). It also allowed nonintelligent termi- 
nals to be run off the servers, eliminating the 
need for some dedicated PC clients. The abil- 
ity to have clients either local or remote to the 
server was possible Complete interoperability 
of the system was maintained by the DB2 
client/server support. 


ADDING TERMINAL 
SUPPORT TO 0S/2 WARP 
The last portion of the architec- 
ture was the terminal server, 
which connected the central 
database clients to the airports. 
The airports provided reserva- 
tion terminals at the check-in 
counters and departure gates. 
As such, the imposing routers 
and gateways would make the 
solution expensive and man- 
agement-intensive. A multi- 
user system eliminated this 
problem because the multi- 
user cluster could be located 
either at the Reservation 
Center or at the airport. In ad- 
dition, remote printing of tick- 
ets and reports would be avail- 
able at both the check-in and 
departure gates. 

The decision was made to 
use a currently available prod- 


Fi=Help 
Press ENTER 


uct, REMOTE-OS, instead of Figure 1. [ARS can provide an affordable alternative for a reservation system. 
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writing the terminal support in-house. This 
decision was based on REMOTE-OS's ability 
to provide both the terminal support as well 
as the required network connectivity. 


PERFORMANCE TUNING 

Stored procedures were used to reduce the in- 
teraction between the client and server. This 
alone resulted in an approximate 50% reduc- 
tion in communication between the two. To 
improve performance, only static SQL state- 
ments were used (as opposed to dynamically 
executed statements). Sorting and ordering 
were held to a minimum to reduce execution 
time. (When DB2 resides on the OS/2 system, 
as much real storage as possible is made 
available.) These steps resulted in a system 
that provided a predictable performance that 
was within our design criteria. 


BUILDING THE FRONT END 
TARS provides a friendly user interface in- 
cluding action bars, pull-downs, message 
windows, and parallel dialogues such as on- 
line contextual help (Figure 1). The operator 
interface is self-prompting, self-educating, 
and provides examples of allowable data for 
entry. Each operation consistently follows the 
same steps each time. OS/2 Warp’s 
Presentation Manager was not used since that 
would limit remote terminals to intelligent PC 
systems and drive up our costs. 

DB2 provides the ability to query the 
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REXX Diagnostic 
Commander 
Makes REXX 

Debugging Easy 


Software developers, ad- 
ministrators, and all OS/2 pro- 
fessionals can efficiently code 
and test REXX command files 
in a completely interactive envi- 
ronment. Easy to use, RDC 
enhances your code writing abil- 
ity while increasing productivity. 
Programs are debugged easily 
and quickly! 


¢ Supports Multiple 
Platforms 

e¢ Source Code Display 

* Variable Display Service 

® Variable Alteration 

* Single Step Review 

¢ Dynamic Watch 
Windows 

* Logic Alteration 

¢ Deferred Debug Option 
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database via menu-driven forms, speci- 
fying data fields, logical relationships, 
and sequences. An example of a fixed 
“query” is a passenger who calls with 
questions about a reservation but does- 
n't remember the confirmation number. 
The operator can enter the passenger's 
last name, or a smaller subset of the 
name, on the panel. The result is a view 
of similar names with home and office 
phone numbers, where the operator, 
prompted by the passenger, scrolls to 
the correct reservation. At this point, 
the system displays the outbound and 
inbound flights for the passenger, and 
the selection continues until the passen- 
ger is fully serviced. 

When a graphical interface to DB2 
becomes a requirement—because the 
terminals are GUI capable—the GUI- 
WYSIWYG look and feel can be added 
using IBM's GUI DB2 tools, without 
changing any code in TARS itself. In 
addition, DB2 provides an export/im- 
port function to most spreadsheet or 
word-processing applications, so the 
customer is still not obligated to “our 
way of thinking.” Further, DB/2 pro- 
vides the necessary data security and 
data integrity support, an absolute re- 
quirement for an airline reservation 
system. 


A CLIENT/SERVER AIRLINES 

RESERVATION SYSTEM 

The TALRS project achieved the goal of 
providing the airlines with an afford- 
able alternative for a reservation sys- 
tem, while still providing the function 
of larger systems. The self-training user 
interface lets an airline hire agents unfa- 
miliar with airline industry jargon and 
spend less than a day training them. 
This alone more than justifies the sys- 
tem in the eyes of airline management, 
saving several weeks for each counter 
or reservation person. 

The DB/2 database provides com- 
prehensive reporting on a real-time 
basis. This allows management to make 
decisions immediately, rather than 
waiting until tomorrow for a report. 
TARS is completely configurable, on a 
real-time basis, and flights can be cre- 
ated, edited, and rearranged as needed. 
This would be impossible without a re- 
lational database. 

TARS can be connected with other 
reservation systems used by indepen- 
dent travel agents. Reservations are 
simply downloaded into TARS once the 
local PC has polled the other reserva- 
tion system(s) and extracted all reserva- 
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tions made by the independent agents. 

TARS has been installed at several 
airlines and has proven to be successful 
and the design criteria realized. 

The growth of OS/2 Warp, DB/2, 
and C functionality should pave the 
way for future enhancements that are 
not previously available to small air- 
lines, such as adding voice response ca- 
pability to TARS. From an application 
development point of view, software 
designers are positioned to take advan- 
tage of hardware and software progress 
without having to wait. 

The nicest part about this project 
was that once the tools were selected, 
the focus went to application develop- 
ment. OS/2 provided the multitasking, 
multithreading environment. LAN 
Server provided the peer-to-peer and 
PC support. DB2/2 provided the en- 
gine and support for the structured and 
unstructured queries for an endless va- 
riety of reports. Finally, REMOTE-OS 
provided the local and remote access to 
PCs and terminals, eliminating a lot of 
low-level programming. 


Jim Monroe was employed by IBM for 30 
years until 1989. Since then, he has developed 
various OS/2- and DB2/2-based applications 
for the retail and airline industries. He can be 
reached at 407-361-0109, fax 407-361-9851 or 
via CompuServe at /4230,2407. 
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y% ® Using OpenDoc as a multiplatform 
By ROBERT C. YEAGER 






“killer” application framework. 


OpenDoc—More 
Than Just Documents 


he forthcoming OpenDoc technol- 
ogy, jointly developed by IBM, 
Apple, and WordPerfect, is cur- 
rently promoted as an open-architectured 
compound document technology in current 
literature. This description provides ample 
ammunition for authors to compare and con- 
trast OpenDoc and its chief competitor, 
Microsoft’s OLE (Object Linking and 
Embedding). This viewpoint has been pro- 
moted to provide developers and users with 
a clear product identity against the competi- 
tion. Currently, much ink is being spilled in 
comparing and contrasting OpenDoc and 
OLE as compound document editors. 

This is unfortunate because OpenDoc 
has a deeper and more subtle technical foun- 
dation than the description “compound doc- 
ument editor” implies. What OpenDoc really 
represents to software developers is a plat- 
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Figure 1. The OpenDoc plumbing system. 
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form-independent, language-independent 
application framework. 

Much of OpenDoc’s capabilities are di- 
rectly attributed to the use of IBM’s System 
Object Model (SOM) in implementing 
OpenDoc. After some early growing pains, 
SOM has now matured enough to be ready 
for prime time. SOM is a proven, reliable 
technology, as demonstrated by OS//2's 
Workplace Shell. After lurking under the 
hood of OS/2 for two years, SOM is ready 
for the spotlight as OpenDoc is unveiled. 

The purpose of this article is to present a 
view of OpenDoc as a prebuilt multiplatform 
application framework for developers. This 
viewpoint avoids the abstract document-con- 
tainer-part terminology usually associated 
with OpenDoc in favor of framework-class- 
subclass terminology. Framework-class-sub- 
class terminology is used in formal object- 
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oriented design methodologies such as the 
Booch method. Hopefully, this will allow 
you to break the association of OpenDoc 
with documents and concentrate on 
OpenDoc as an object-oriented development 
platform, which may be used to develop any 
type of application. 

We will start off by first examining 
early frameworks and the limitations in 
their use. I'll then introduce SOM technol- 
ogy, showing how it alleviates the prior 
shortcomings of frameworks. A general 
overview of the OpenDoc framework design 
will liken the OpenDoc framework to a 
plumbing system complete with pipes, 
faucets, and caps. Finally, a short OpenDoc 
sample subclass will be developed to 
demonstrate the ease of writing a new 
OpenDoc application. The sample will port 
the DIVE (Direct Interface Video Extensions) 
sample program from the OS/2 Multimedia 
Toolkit to OpenDoc. So prepare to DIVE 
into OpenDoc! 


VANILLA FRAMEWORKS 

Frameworks are best described as cooperat- 
ing object-oriented classes, which when used 
collectively provide a working piece of func- 
tionality. For example, the IBM C++ User 
Interface classes form a framework that col- 
lectively provides an object-oriented pro- 
gramming interface to access the OS/2 
Presentation Manager APIs. Many types of 
frameworks currently exist to solve common 
problems. A Collection framework provides 
access to arrays, linked lists, and queue 
structures, while Persistence frameworks 
allow objects to save their current state to 
permanent storage (that is, save data to 
disk). 

Frameworks take advantage of previ- 
ously written and debugged code and allow 
framework users easy access to that working 
functionality. As an added bonus, frame- 
work users are able to extend the frame- 
work's functionality by subclassing frame- 
work classes. Subclassing a framework class 
allows the developer to inherit all the func- 
tionality of the base class and add new func- 
tionality, as well as remove or replace exist- 
ing functionality. 

The ability to add, remove, or correct 
framework functionality makes them very 
flexible in solving development problems. 
Adding functionality to a framework is criti- 
cal to promoting code reuse. Removing exist- 
ing framework functionality is a prerequisite 
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to replacing functionality so as to correct 
framework bugs or to optimize performance. 

The power of frameworks to date has 
been limited to providing developers with 
existing functionality wrapped externally 
with object-oriented classes. User Interface 
frameworks, Collection frameworks, and 
Persistence frameworks functionally provide 





Listing 1. A new IDL source file that describes a new class. 
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nothing new. Their power lies in mak- 
_ ing functionality easy to use and to ex- 
tend. By themselves, frameworks 
haven't made the chore of writing an 
entire application much easier. 
Frameworks also have had severe 
limitations in their use. In the past, 
frameworks could only be used from 
the programming language, which 
used to develop the framework itself. 
A framework written in C++ was use- 
less to a Smalltalk developer and vice 
versa. Also, different language compil- 
ers were even incompatible, most no- 
tably with C++. This incompatibility of 
frameworks isolated them from the in- 
creasingly heterogeneous client-server 
solutions of today and was a limitation 
on promoting business-wide code 
reuse. 
Another limitation in using frame- 
works occurred when the framework 
needed to be updated or corrected. 
Updating the framework would re- 
quire all clients using the framework 
to be recompiled because the frame- 
work didn’t preserve backwards bi- 
nary compatibility. This synchroniza- 
tion dilemma made frameworks 
cumbersome to maintain and update. 


SOM FRAMEWORKS 

SOM technology breaks down the ear- 
lier barriers to object-oriented frame- 
works. SOM is not a programming lan- 
guage but rather an object packaging 
technology. SOM is much more com- 
prehensive than the short discussion I 
will present here, which will serve 
only to demonstrate a portion of its ca- 
pabilities in correcting the prior short- 
comings of frameworks. 

SOM allows frameworks to be 
used by any programming language 
that has SOM bindings available. 
Currently, SOM bindings exist for C, 
C++, Smalltalk, and ObjectREXX. 
COBOL bindings have been indicated 
to be forthcoming shortly. As you can 
see, even procedural (nonobject-ori- 
ented) languages such as C, COBOL, 
and REXX can use frameworks using 
SOM technology. 

SOM also preserves backwards bi- 
nary compatibility, so that when a 
framework is updated the client pro- 
grams don’t have to be recompiled. 
Backwards binary compatibility makes 
it feasible to package frameworks as 
shareable binary DLLs, which is ex- 
actly how the OS/2 Workplace Shell is 
distributed. 


THE OPENDOC PLUMBING SYSTEM 
OpenDoc has the technology to revo- £ , . 
lutionize the software development __ Listing 2. A completed program. (Continued on page 41.) 


40 OS/2 DEVELOPER 





process. This is because OpenDoc is a 
platform-independent, language-inde- 
pendent application framework. 
OpenDoc’s power comes from the 
usage of IBM’s SOM technology to im- 
plement OpenDoc. 

SOM provides OpenDoc with lan- 
guage-independence, but by itself 
doesn’t ensure platform independence. 
Only the careful design of the 
OpenDoc framework provides this fea- 
ture. OpenDoc essentially provides a 
complete plumbing system for an ap- 
plication. Figure 1 depicts a portion of 
the OpenDoc design. Whenever Open- 
Doc can provide a service that can be 
implemented across platforms, such as 
graphical clipping algorithms, it pro- 
vides a working faucet that a devel- 
oper can immediately unscrew. When 
OpenDoc runs into platform-depen- 
dent service, such as the actual draw- 
ing commands for a graphical object, it 
carefully caps off the pipe in such a 
way that a developer can easily fit a 
faucet of his/her choosing. OpenDoc 
part development tools will provide a 
means for designing these platform- 
specific faucets. 

The OpenDoc plumbing system is 
extendible. This can be accomplished 
by purchasing or designing new 
faucets (such as three-dimensional pie 
charts or multimedia parts) or by pur- 
chasing or designing new extensions or 
modifications to the OpenDoc plumb- 
ing system, complete with faucets 
(word processors, spreadsheets). 

Even though OpenDoc provides 
the complete plumbing of an applica- 
tion, this doesn’t require that all appli- 
cations have the same look and feel. 
This is because OpenDoc’s root part 
(the document shell) can be replaced at 
startup. This gives developers the op- 
portunity to create their own shell, 
customizing it as needed. Creating a 
shell doesn’t require writing one from 
scratch—you can simply override the 
behaviors of the existing shell that you 
want to modify. 


DIVING INTO OPENDOC 

“Yeah, great—so what?” you may ask. 
The implications of OpenDoc cannot 
really be appreciated until you have 
developed an OpenDoc application. 
OpenDoc provides an entire working 
application wrapped in an elegant 
SOM framework, which is portable 
across multiple platforms and can be 
developed with multiple languages! 
To demonstrate the advantages ac- 
quired with OpenDoc, we will take an 
existing program and convert it to 


Li 2. A completed program. (Continued on page 42.) 


SEPTEMBER/OCTOBER 1995 41 





Without going into much detail, 
Direct Interface Video Extensions 
(DIVE) is a multimedia subsystem 
that provides direct access to video 
hardware. The DIVE APIs automati- 
cally detect and use video accelerator 
hardware to provide extremely fast 
video updates suitable for games and 
animation. 

The DIVE sample that we will con- 
vert to OpenDoc can be found in the 
OS/2 Warp Developer Toolkit on the 
Developer Connection CD-ROM vol- 
ume #7. (We will not reproduce the 
original source code here for brevity.) 
The converted program will require the 
OpenDoc Developer Tool-kit, OS/2 
Warp Developer Toolkit, and the OS/2 
Warp Fixpack #5—all on the Developer 
Connection CD-ROM volume #7. 

The first step in developing for 
OpenDoc is to choose an appropriate 
class to subclass. This allows you to 
inherit behaviors (code) free of 
charge. Because this will be a minimal 
conversion to OpenDoc, I have se- 
lected the Simple class from which to 
start. As you develop in OpenDoc, 
you can reuse your existing code 
through subclassing. 

To hook into OpenDoc, you must 
first use the SOM compiler to create 
your new class. This involves writing 
an IDL (Interface Definition Language) 
source file, which describes your new 
class. Remember that SOM is language 
neutral—the IDL is the key to this neu- 
trality. IDL is nothing more than a 
class-definition language. 

Our IDL, for this example, is 
shown in Listing 1. It defines our new 
class, DIVEPart, and the methods of the 
parent class which to override. The 
critical overrides are the FacetAdded, 
FacetRemoved, GeometryChanged, and Draw 
methods, which will process the em- 
bedding, removal, and drawing of the 
DIVE part. 

After writing the IDL definition, 
invoke the SOM compiler to generate a 
stub file and supporting headers. The 
stub file contains the entry points for 
new methods and overrides. At first, 
every entry point will be either empty 
for new methods or contain a call to 
the parent method for overrides. 

If we were to compile the pro- 
gram without modifying the C++ 
source file, the resulting program 
would function exactly as the parent 
Simple class. You would also find that 
the resulting size of the DLL would be 
small. This is the magic of inheritance. 

Listing 2 shows the completed 
program with the DIVE components 
embedded in the appropriate over- 
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rides. The Facethdded method is called 
by OpenDoc whenever the user em- 
beds a part, so I have placed the cre- 
ation of the DIVE PM window here 
and the startup of the animation. 
FacetRemoved is invoked when the 
part is deleted, so I must stop the ani- 
mation and remove the DIVE window. 

The GeometryChanged method con- 
trols part movement and resizing by 
the user. Note that here we must con- 
vert the platform-independent coordi- 
nates provided by OpenDoc into plat- 
form-specific coordinates for use by 
PM. OpenDoc provides the necessary 
transformation matrices to do the dirty 
work for us. 

The dirty work of actually doing 
the DIVE screen updates is processed 
in a second thread, which was 
spawned when the part was embed- 
ded. Therefore, the overridden Draw 
method needs to only tell the sec- 
ondary thread to refresh the screen. 

That's it! With the exception of 
converting OpenDoc coordinates to 
PM coordinates, not much has been 
added to accomplish the conversion. 
In fact, the sample lost a few pounds of 
code in the process. This is because 
OpenDoc already handles a lot of low- 
level dirty work such as starting a PM 
message processing loop. What re- 
mains is the heart of the application, 
the actual DIVE commands controlling 
the screen updates. This is the future 
of application development—focusing 
on your particular area of expertise, 
not on the periphery code, which is te- 
dious but required. 

If DIVE were available on other 
platforms, this sample could also func- 
tion on those with minimal modifica- 
tions. Assuming the DIVE API was 
portable, only the PM APIs and the 
thread creation APIs would need to be 
recoded. That’s quite a bang for the 
buck! 

This fully functioning example, 
complete with a three-dimensional jet 
animation, can be downloaded from 
the OS2DF2 CompuServe forum. Look 
for the file DIVE.ZIP in LIB 13. This 
sample will also be available on a fu- 
ture Developer Connection CD-ROM. 


CONCLUSION 
A typical method of starting develop- 
ment on a program is to use a working 
template as the starting point. Most 
development toolkits provide the 
source code for dozens of working 
programs, which can be used as work- 
ing templates to start development. 
— "== This provides the developer with 
Listing 2. A completed program. (Continued on page 46.) working functionality, which can be 
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Listing 2. A completed program. (Continued on page 47.) 


46 os/2 DEVELOPER 





a 


2. A completed program. (Continued on page 48.) 
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augmented until it becomes a finished SS 


application. Usually, however, the detata Facets: /* Delete the ordered callectiont/ 
samples are severely limited in scope on —=— 
and tend to provide only a single —— 
working piece of functionality, such as /* THE FOLLOWING DIVE FUNCTIONS +/ 

a bit map viewer or a menu bar. To 7+ AVE SGT BEEW MOOTFIED FRM #/ 


make a fully functioning application He rie Sts igs A 


usually requires the splicing together VOID APIENTRY DirectMoveMem (ULONG parmi) 
of many provided samples. { 

OpenDoc can change the way ap- } 
plications are designed, programmed, ULONG ReadFile (ULONG iFile, PSZ pszFile, PWINDATA puinData) 
maintained, and used for the better. { 

You can now disassociate OpenDoc } 

from compound documents and think 

of it more as a starting point for appli- ‘are FAPENTRY RyllindowProc (HWAD Ihund, ULONG msg, APARIN pt, RPARIN a2) 
cation development. } 

OpenDoc has the technology to 
not only become the application that 
OS/2 users have been waiting for, but 
also the application framework, which __ Listing 2. A completed program. (Continued on page 48.) 

OS/2 developers have been craving. 
Hope I was able to keep you afloat 
from this DIVE into OpenDoc! 
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A tutorial on database design with an eye to the future. 
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Database Design 
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Figure 1. Part of the original, unrefined alumni mailing list. 


database, according to the model I 
have grown up with, in its simplest 
form, is a two-dimensional array 
usually characterized as a table of rows and 
columns commonly represented by a 
spreadsheet. The rows represent so-called 
entities, and the columns are attributes with 
which the entities are endowed. A simple 
example is a mailing database, which con- 
tains names and addresses for generating 
labels and possibly includes other informa- 
tion about the named individuals that can 
be used for selection purposes. In spread- 
sheet form, each row corresponds to one 
label and the columns contain the separate 
bits of required data: names, street ad- 
dresses, cities, states, zip codes, and per- 
haps phone numbers, business addresses, 
and other facts about the people repre- 
sented. For example, a university's alumni 
mailing list might include the year of grad- 
uation, degrees, honors, and whether the 
current dues to the Alumni Association are 





in arrears. 
In the current frenzy for multimedia, 








software object orientation, and World 
Wide Web hypertext links, this simple 
model might need to be enhanced in vari- 
ous ways. I’m inclined to argue, however, 
that its underpinnings remain substantially 
unchanged. One might add to the attributes 
an image depicting the alumnus/a at the 
graduation ceremony, a sound byte from 
the phone call that explains how the check 
for the current dues payment is in the mail, 
or even drop in a pointer to a folder that in- 
cludes yet other objects associated with this 
person, Nevertheless, we can still work 
from the spreadsheet model in which these 
additional attributes are handled by new 
columns with pointers linking the entity to 
these various objects. 

This brings us to our first design topic: 
refining table structure. Upon closer exami- 
nation of the mailing database, you may no- 
tice that each entity has been endowed with 
a certain amount of redundant information 
that might be worth eliminating. A simple 
example is the state of residence and the zip 
code. Perhaps, out of a desire to sustain the 
moral fabric of America, 
postal zip codes are not 
permitted to cross state 
lines. Accordingly, if I 
know people's zip 
codes, then I know the 
state in which they live. 
I could, therefore, elim- 
inate the state field 
from the records in my 
mailing list by adding 
to the database a sepa- 
rate table in which zip 
codes and states are 
matched. To print the 
address, the label pro- 
cedure first checks the 
zip code, then goes to 
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the new zip/state table to retrieve the two- 
character state code. It probably takes 
longer, but it’s much more elegant and, 
more important, it dramatically enhances 
data management. Okay, so there's not 
much management enhancement here, but 
consider the following similar scenario. 

Suppose, for the sake of this illustra- 
tion, the U.S. Postal Service and Ma Bell de- 
cide to give zip codes and area codes coin- 
ciding boundaries. In your mailing 
database, you eliminate the redundancy by 
creating a table that links area and zip 
codes. If you know the zip code, you have 
the area code because no zip code region 
crosses area code boundaries. Now, as it 
happens, the phone company is running out 
of numbers in the present area code blocks, 
and they plan to realign them. Suddenly, 
5,000 records in your mailing database must 
have the area code field changed to reflect 
the new assignments. So, which method 
will be the fastest and most accurate: chang- 
ing 5,000 records individually and worrying 
about whether you forgot or made any mis- 
takes, or going to the area/zip code table 
and changing just the zip code records that 
have received new area code assignments? 
Therein lies the gain, which is to be had by 
building so-called relational or hierarchical 
databases with linked tables joining shared 
information. 


NORMAL FORM 
The type of construct we have just reviewed 
is formalized in a set of standards called 
Normal Form. Normalizing a database en- 
sures that the attributes associated with any 
particular table belong only to the entities 
singled out in the 
records of that table. In 
less jargon-laden terms, 
normalizing a database 
makes sure that each 
column in the table’s 
spreadsheet says some- 
thing unique and spe- 
cific about the occupant 
of each row. In addi- 
tion, Normal Form sets 
standards for the rela- 
tionships that may be 
defined between one 
table and another. 
These standards go 
well beyond the simple 





within records. The rules for their imple- 
mentation are sometimes written in a lan- 
guage near and dear to the theoretical 
mathematician, so in the interest of clarity, | 
will endeavor to paraphrase and offer some 
illustrations. 

The mailing database currently has two 
tables: the alumni table, which uses some- 
thing unique to the individual like a Social 
Security number as a key to identify each 
record, and the zip/area code table, with 
zip code as its key. The two tables are 
joined on the zip code field, which they 
share. For the sake of the following exam- 
ples, assume that the alumni table also has 
fields for degree earned and in what year, 
the major area of study, and up to three 
past and present employers along with hire 
dates and job titles. 

The head of the Alumni Association 
has decided that the mailing list should be 
expanded into a more comprehensive data- 
base. You review the records, and your at- 
tention is drawn to the repeating groups of 
employers, hire dates, and job classifica- 
tions. This violates the stated goal of mak- 
ing each assigned attribute unique. We cur- 
rently have three different sets of attributes 
providing inherently similar information 
about each entry in the mailing list. It 
makes more sense to separate these into a 
table of their own, with a separate record 
for each employer. The key will be a combi- 
nation of two fields, the alums’ Social 
Security number, identifying the corre- 
sponding record in the alumni table, and 
the name of the employer. The additional 
attributes are the hire date, the job title, the 
degree earned at the school, and the major 





removal of redundancy Figure 2. The fields as they appear in the non-normalized table. 
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Figure 3. [he three linked record types in the billing system. 


subject area of study. The latter fields 
have been included to indicate the 
suitability of the educational experi- 
ence to the job currently held (or not, 
as the case may be), such as the CEO 
has an MBA. 

A second set of potentially re- 
peating groups is the degree received 
and the year of graduation. While 
most received only a single degree, 


some may have stayed on or returned 
for one or more advanced degrees. A 
separate table, keyed jointly on 
alumni code and degree with gradua- 
tion date as the remaining attribute, 
would take care of this repetition. 

The elimination of these explicit 
or potential repeating groups places 
the alumni table into First Normal 
Form. It has the further advantage of 
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more easily adapting to situations 
where there are more than three em- 
ployers to track. 

In taking a second look at the 
alumni-employer cross-reference 
table, there appears to be something 
not quite right about having dupli- 
cated the degrees and subject majors 
in each of these records. While includ- 
ing this information may have some 
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Figure 4. DataEase maintains referential integrity when defining the relationship between product 


and invoice. 


merit for the university’s image, it is 
logically unsound from a design per- 
spective. The hire date and job title 
are attributes of both the individual 
and the indicated company taken to- 
gether, and hence inform about the 
entire record key, which combines 
both the individual and employer 
fields. The degree and area major say 
something only about the individual, 
not about the company. Remembering 
that a goal of Normal Form is to 
achieve attributes both unique and 


specific, these two attributes should 
properly (or normally) remain back in 
the alumni table, where they are spe- 
cific to the individual members, in- 
stead of being inserted into the 
alumni-employer cross reference. 
Returning the degree and major 
to the alumni table places the cross- 
reference table in Second Normal 
Form. All attributes are associated 
with the entire compound key, not 
merely with some parts of that key. 
The alumni table is in First 
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Normal Form because we eliminated 
repeating groups and in Second 
Normal Form by default (because it 
has no compound key). The elimina- 
tion of the zip/area code redundancy 
has also placed it in Third Normal 
Form. Given the hypothetical scenario 
sketched out earlier, the area code has 
effectively become an attribute of the 
zip code and is no longer specific to 
the alumni list member. The goal of 
Third Normal Form is to remove 
overlapping and, hence, redundant 
attributes within a table, consigning 
them to tables of their own where the 
data can be more easily managed. In 
essence, without the introduction of 
the area code/zip code table, we have 
two attributes doing the work ina 
table where one will suffice. 

There are also Fourth and Fifth 
Normal Form standards that relate to 
the isolation of independent or seman- 
tically related multiple relationships. 


REFERENTIAL INTEGRITY 

Normal Form is designed to protect 
information by splitting it up in vari- 
ous ways. For example, in the alumni 
database, it might be advisable to 
break out employers into their own 
table instead of confining them to the 
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alumni-employer cross reference. If 
the last alum who worked for a given 

company dies and is removed from 
the records, all record of that com- 
pany goes too. But, splitting up infor- 
mation is not without its adverse con- 
sequences, which brings us to our 
second topic—referential integrity. As 
soon as you decide to distribute infor- 
mation among multiple tables, you 
have to deal with what happens to the 
data in one table when you make 
changes in another. 

To change illustrations, a billing 
system contains a table of customer 
information, including discount rates 
based on volume, a product table, and 
an invoice table containing records of 
current and past transactions. The 
price paid on the invoice is calculated 
from the list prices, taken from the 
product table, and the discount rate 
from the customer table. 

What happens in the invoice table 
when there is a change in the product 
table’s list price or in a customer's dis- 
count rate? Common sense dictates 
that the change should only be applic- 
able to invoice records created after 
the date of the revision. This can be 
handled by incorporating the revision 
date in the “parent” customer or prod- 
uct record and using a compound key, 
which contains the new rate or price, 
plus an effective date to define the af- 
fected invoice records. Easy enough. 
On the other hand, if business is good 
and it becomes necessary to expand 
the number of characters in the cus- 
tomer account key, such a change 
should be cascaded through all the as- 
sociated invoices and any other tables 
containing customer-related informa- 
tion. Last, let’s suppose a customer 
leaves the fold and the corresponding 
customer record is deleted. Should the 
corresponding invoice records be 
deleted at the same time, archived, or 
left in their original locations in the in- 
voice table? The challenge for the de- 
veloper lies in identifying all of these 
potential scenarios during discussions 
with the client user and then including 
the required fields and associated rou- 
tines to cover them. However, equally 
important is that the database develop- 
ment tool chosen for the project is, 
shall we say, robust enough to accom- 
modate these demands. 


DATAEASE 

There aren’t a great many develop- 
ment tools written specifically for 
OS/2 or tools that have been ported 
over successfully from either the DOS 
or Windows arena, but one interest- 
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ing exception is DataEase, a product 
from DataEase International Inc. 
DataEase has had OS/2 versions dat- 
ing back to the days of the 1.x ver- 
sions and, only recently (with release 
5.0), has marketed a complete 
Windows offering. DataEase supports 
multi-user applications through net- 
work file- and record-locking fea- 
tures. Through a separate product, 
SOL Connect, DataEase applications 
can be defined in a client or server en- 
vironment, using the same client side 
features that are available for desktop 
and LAN-based projects. Over the 
years, DataEase has remained a solid 
development tool, which has not only 
won a following in the user market 
but has also formed the basis of sev- 
eral commercial applications. 

[ cite DataEase here because, in 
addition to offering a native OS/2 
version, it is a tool in which I have 
done the majority of my database de- 
velopment projects. It was not a prod- 
uct of choice, but one already in place 
when I joined the law firm where I 
work. Nevertheless, having done 
maintenance work in other systems, 
DataEase is the product I always re- 
turn to for new applications. As its 
name is intended to suggest, it is ex- 
tremely easy to build quick and clean 
prototype systems. Where | work, liti- 
gators are busy with the process of 
discovery, and rarely discover the 
need for data-processing support 
until the eleventh hour. This some- 
times means that I hear about the 
needed application on a Friday, and it 
must be finished and into production 
on the following Monday. 

DataEase incorporates a number 
of built-in features that assist in 
achieving the standards of normal 
form and referential integrity. It thus 
serves as an illustration of how these 
requirements can be enforced in ap- 
plications that are written using third- 
party development software. 


LINKING TABLES 

With respect to referential integrity, 
DataEase links tables with a simple 
method that uses up to three related 
fields. When defining a relationship 
between two tables, the designer has 
the option of specifying how changes 
in the key fields defining the linkage 
should be handled. 

The choices are Cascade, Null, 
and Restrict. Cascade means that 
child records will be changed to re- 
flect changes in the parent and are 
deleted when the parent record is 
deleted. In other words, modify or 
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lose the customer and the invoices are 
modified or deleted as well. 

Null means that the correspond- 
ing key value in the child records will 
be set to BLANK when the value in the 
parent is changed. The child records 
are still deleted along with the parent. 
The advantage of Null is to purposely 
orphan the child records so that a fol- 
low-up can isolate them and process 
them appropriately. 

Restrict means that changes in 
the parent, including deletion, leave 
the child records unaffected. In SQL 
Connect, two additional integrity 
rules are included to enforce the 
Cascade and Null options on the 
server engine. 


COMPOUND INDEXING 

In earlier versions, DataEase wasn’t as 
congenial to the rules of Normal Form 
as it has become in the current re- 
lease. This may seem like an odd com- 
ment, since Normal Form appears to 
be inherently a design issue without 
regard to the chosen development 
tool. True enough. But realizing the 
chosen design, without making com- 
promises or sacrificing performance, 
depends on the underlying software. 
By way of example, enforcing the first 
and second rules of Normal Form can 
be enhanced by the ability to create 
and maintain compound indexes over 
multiple fields in a record table. 

In earlier versions of DataEase, 
indexing was restricted to individual 
fields. To build a compound index re- 
quired the creation of an indexed 
“dummy” field made up by joining 
the content of the fields logically con- 
nected as the record key. The "join- 
text" function that accomplished this, 
as its name suggests, converted field 
values of distinct types into a com- 
mon text format. This loss of the origi- 
nal field characteristics frequently 
proved impractical for purposes of 
linking records into their required 
relationships. 

The current 5.0 release now sup- 
ports the creation of true compound 
indexing, incorporating fields with 
distinct type characteristics. There 
are, however, two limitations. If you 
are building tables that will be ac- 
cessed from the DataEase for 
Windows software, as well as from 
OS/2 or DOS, tables with compound 
indexes will be viewed as read-only 
from that perspective. Users will be 
able to view but cannot create or 
modify the associated records. 
Additionally, compound indexes can- 
not be defined on SQL or other for- 


eign database tables. At least it’s a 
step in the right direction. 

In choosing a development tool 
for application building in the OS/2 
operating environment, your decision 
ought to be based at least in part on 
how well and how easily the product 
enforces the design standards you 
should be following. If you are think- 
ing about checking out DataEase, one 
downside for OS/2 developers is that 
DataEase for OS/2 is still text-based 
like its DOS cousin. On the other 
hand, with a few exceptions like the 
one noted above, the file formats for 
the 5.0 DOS, Windows, and OS/2 re- 
leases are fully equivalent. This can 
offer an advantage in a setting where 
the users may have a variety of front- 
end operating environments on their 
desktops. 


Charles R. Meyer, who holds a Ph.D. in logic 
and philosophy of science, is senior PC applica- 
tions specialist with the law firm of Bryan Cave 
LLP. Charles has been part of the firm's MIS 
department, based in St. Louis, MO, for eight 
years, and is responsible for programming and 
database development in support of both 
administrative and case management projects. 
Prior to that he worked as a programmer and 
independent consultant and has also taught 
database design and programming. 
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Database Development 


Writing an OS/2 database application, using a genealogy database as an example. 


By JAKE JACOB 


A Multi-Platform 
Database Library 


bout 10 years ago I was looking 

through some family scrapbooks 

and photo albums when Mom said, 
“Why, you could put this all on your com- 
puter, couldn't you?” And without thinking 
(obviously!) I replied, “Sure, that’s what 
they’re for.” Envisioning perhaps as many as 
200 names, I started writing a simple pro- 
gram to record and organize the information 
and print the results. 

By now my records include nearly 3,000 
names, 5 MBytes of text data, and 150 
Mbytes of photographs. It’s time to start 
thinking database program! So when Simple 
Software Solutions offered me an opportu- 
nity to beta test its new database library, I 
asked some questions and was persuaded to 
try it. Although I don’t expect to use all of its 
capacity, | wanted to be able to write my 
own data entry and reporting functions. 

My genealogy database uses multiple 
tables to define parent-child and marriage 
relationships and link them to text and pho- 
tographic data. When I finish all the “bells 
and whistles,” users will be able to view and 
print information about an individual or a 
family. It’s fun to step back from parent to 
grandparent and see their pictures and read 
about their activities. 


AN EVENT-DRIVEN DATABASE LIBRARY: E_DB 
This article describes e_Db, a database li- 
brary product that will soon be available for 
most popular development platforms, in- 
cluding OS/2 Warp. The “e” in e_Db stands 
for events, since the database engine posts 
events back to the application to inform it of 
changes, additions, and deletions. 

The product is a comprehensive set of 
functions, which allows a developer to create 
and maintain databases from applications 
written in C, C++, VisualBasic, and other 
languages that can access functions in a DLL. 


Besides the basic INSERT, DELETE, UP- 
DATE, and SELECT operations, e_Db pro- 
vides many other useful functions. 

The appealing aspects of e_Db are: 

* It completely hides the details of opening, 
closing, and sequencing table and index 
files. 

¢ Its search engine examines the search ex- 
pression to determine what indices (if 
any) to use and how to conduct the search 
most efficiently. 

* It posts events to inform the calling appli- 
cation of database changes, table addi- 
tions, and indices dropped. These events 
are also used to allow customization of the 
database engine’s behavior. For example, 
once the maximum number of locking re- 
tries has been reached, e_Db posts an 
event asking for direction: continue try- 
ing? stop? 

¢ e_Db is available for OS/2 Warp, 
Windows 3.1, Windows NT, VisualBasic, 
and DOS. Versions for OS/? for the 
PowerPC and Windows 95 will be avail- 
able when these systems ship. 

¢ The architecture defines a relationship be- 
tween the database engine and its database 
drivers. A database driver DLL relieves the 
engine from having to know the details of 
file format. Version 1.0 of e_Db is shipped 
with a DBASE III database driver but other 
drivers can be developed. The functional- 
ity of the APIs remains the same regard- 
less of the database driver being used. 

¢ Data files created and maintained on one 
platform can be accessed by implementa- 
tions on other platforms. 

If you develop software in C or C++ 
under OS/2, Windows, NT, or DOS, and 
want to avoid complex database systems, this 
product is worth considering. e_Db’s API set 
provides a consistent interface across all sup- 
ported platforms. It offers a level of refine- 
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ment not found in most other database 
libraries. You never “see” a table or 
index file, just as you never “see” a file 
in more complex database systems. 
You don’t need to write code to scan 
tables or serialize access to tables. 

On the other hand, e_Db lacks the 
user/password validation, referential 
integrity checks, and dedicated backup 
and recovery features found in larger, 
more complex, database systems. 


FEATURES SUMMARY 

With e_Db one can do the following: 

* Create a multiple database dynami- 

cally 

Create and drop tables dynamically 

Manipulate tables in various file 

formats 

¢ Handle multiple databases concur- 

rently 

Create and drop table indices dy- 

namically 

Submit SELECT statements against 

any table 

¢ Submit multicolumn UPDATE re- 

quests 

Submit INSERT and DELETE re- 

quests 

Supply full multithreaded support 

under OS/2 and Windows NT 

¢ Use wildcard characters ? and * to 
search the tables 

e Set case sensitivity at the database 
level 

¢ Compose complex, parenthesized 
expressions for SELECT, UPDATE, 
and DELETE statements 

e Use C language structures to manip- 
ulate table rows 

¢ Import and export data to/from a 
table with a single function call 

¢ Catalog and uncatalog tables dy- 
namically 

¢ Notify when new tables or indices 
are created by other users 

* Notify when maximum number of 
rows is reached during SELECT op- 
erations 

¢ Notify application when tables are 
removed 

¢ Open a database for exclusive, 
shared, or view only access 

¢ Treat select results as an array of 
rows 

¢ Supply a callback mechanism for 
SELECT statements 

* Supply a callback mechanism for 
UPDATE statements that allows 
you to perform special updates. 


DATA TYPES 

Data types that are not directly 
supported by the chosen file format are 
emulated by its database driver. For ex- 
ample, in Table 1, CT_WORD (unsigned 
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Symbol Description 
CT_FSTRING Fixed-length character 
CT_NUMERIC Formatted numeric value 
CT_BOOLEAN Boolean variable (‘T’ or ‘F’) 
CT_DATE Date column (YYYYMMDD) 
CT_VSTRING Variable length character 
(DBASE memo field) 
CT_BYTE Unsigned binary byte 
CT_WORD Unsigned short (two bytes) 
CT_DWORD Unsigned long (four bytes) 
CT_FLOAT Floating point number (double) 
CT_SHORT Signed short (two bytes) 
CT_LONG Signed long (four bytes) 
CT_TIMESTAMP Unsigned short (two bytes) 
CT_COUNTER Unsigned long (four bytes) 
(increments automatically) 


Table 1. e_Db supported data types. 


Column type Description 

fstring(n) Fixed string of n characters 

numeric(v:d) Numeric value of ‘w’ bytes with ‘d’ decimal places 
boolean 1-byte wide. Y or N. 

date 8-byte wide date. YYYYMMDD 

vstring 4-byte wide reference to a variable length string 
byte 1-byte wide unsigned value 

word 2-byte wide unsigned short value 

dvord 4-byte wide unsigned long value 

float 8-byte wide double value 

short 2-byte wide signed short value 

long 4-byte wide signed long value 

counter 4-byte wide unsigned long value 

timestamp 2-byte wide unsigned short value 


Table 2. e_Db column types. 


short) is not directly supported in the 
DBASE III file format but the database 
driver emulates it using DBASE III's 
‘numeric’ type. Regardless of the data- 
base driver you’re using, your applica- 
tion always handles a CT_WORD as a two- 
byte unsigned short variable. 


USING A DATABASE 

Let’s look at a few of e_Db’s APIs with 
some “snippets” of pseudo code to get 
a better idea of how they are used. 

Before you call any other func- 
tions, you must create a database en- 
gine instance with a call to 
DbmCreateEngineInstance. This function re- 
turns a handle, which is used to create 
and/or open the database(s). 

After the database is created, you 
can dynamically create and drop the 
tables and indices you need. The data- 
base instance handle is also used to 
“shutdown” the engine’ with 
DbmShutdownEngineInstance. The sequence 
involved in creating and manipulating 
a database is: 
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DbmCreateEngineInstance() 
DbmCreateDatabase() // if it doesn’t exist 
Dbm0penDatabase( ) 

DbmCreateTable() 

DbmCreateIndex () 

DbmInsert() 

DbmSelect() 

DbmUpdate( ) 


DbmCloseDatabase() 
DbmShutdownEngineInstance() 


When you create a database the 
engine produces a database dictionary 
file named after the database name 
you specify. This file has the extension 
.dbd. 


For example, 
int rc; 
HDBINST hdbinst; 
rc = DbmCreateEngineInstance(&hdbinst) ; 
if (rc == DBSUCCESS) 
{ 
rc = DbmCreateDatabase( 


hdbinst, 

// Database instance handle 
"C:\\GENEALOG", 

// Produces C:\GENEALOG.DBD file 
"My relations database", 

// Database description (pun 

intended) 

"dbase3", 

// Database driver (DBASE IZ) 
"db3dllo", 

// The driver’s dll name (05/2) 
CROB_OVERWRITE) ; 

// Qverwrite if exists 


} 


OPENING A DATABASE 

You must open the database in one of 
its three modes before you can use it. 
In exclusive mode, you have full ac- 
cess to the database and can create and 
drop tables and indices. In shared 
mode, you cannot drop database ob- 
jects, and in view mode, you are only 
allowed to search the tables, and no 
changes are permitted. 


CREATING A TABLE 
A table is defined by a column specifi- 
cation containing one or more column 
descriptors of the form “Name 
type(width)”. See Table 2 for column 
types. 

In this example, 


HTABLE hTable; 
int rc; 
rc = DbmCreateTable( 

hdb, 
"Genealogy Main Table", 
"Person_Id counter," 
"LastName fstring(30) ," 
"FirstName fstring(30) ," 
"Date_of_Birth date," 
"Place_of_Birth fstring(50) ," 
"Date_of_Death date," 
"Place_of_Death fstring(50)," 
"UpdateDate date," 


"Comments vstring", 
&hTable) ; 


would create a table for use in a ge- 
nealogy program application. 


CREATING AN INDEX 
Create an index with the DbmCreateIndex 
function. If an index already exists for 
the specified column, it will be rebuilt. 
The database engine automati- 
cally updates the index as you add, 
delete, and modify table rows. It also 
decides which indices to use during 
the execution of a SELECT, UPDATE, 
or DELETE operation. 
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Listing 1. An example of search criteria. (Continued on page 60.) 





TRUE) ; // trim trailing blanks 





rc = DbmGetSelectColumn( 





// OR, extract each column individually with DbmGetSelectColumn 


hselect, // handle to select results 
ay // the row offset (0-based) 
0, // Table handle (not used here) 


"Date_of_Birth", 
szDateofBirth, 
TRUE) ; 


// Column to extract data from 
// Store the extracted data here 
// Trim blanks from result 


Finally, free the memory associated with the select results handle 


DbmFreeSelect(hselect); 


Search expressions are reusable from one operation to another, however, 
they can only be used by one thread at a time. 


Listing 1. An example of search criteria. (Continued from page 59.) 


ADDING ROWS TO THE TABLE 

A “data space” is associated with a 
particular table and is an internal rep- 
resentation of the data buffer that 
holds the data for one row. Once you 
have a valid “data space handle,” you 
can set the column values or, if you 
have an appropriate C structure you 
can transfer its contents to the data 
space all at once. A data space is cre- 
ated by a call to DbmCreatDS. 


The easiest way to insert a row into 
a table is by transferring the contents of 
a structure (or VisualBasic user-defined 
data type) directly to a data space be- 
fore calling DbmInsert. If you are not 
using structures to manipulate the table 
rows, you must fill the data space by 
using DbmSetColumn for each column. 


SEARCHING A TABLE 
To search a table, call function 


HTABLE hTable 
int rc; 

long count; 
HUB hub; 


rc = DbmCreateExpression(hTable, &hexp); 
if (rc == DBSUCCESS) 
{ 


DbmhddExpressionTerm(hexp, "LastName", OP_EQ, "Smith"); 


DbmAddLogical0perator(hexp, LOGOP_AND); 


DbmAddExpressionTerm(hexp, "FirstName", OP_EQ, "John"); 


rc = DbmCreatellpdateBlk( 
hTable, // Table handle 
hhub); 


if (rc == DBSUCCESS) 
{ 


// Set John Smith’s date of birth to 10-12-53 


// Update block handle returned here 


DbmAddUpdateAction(hub, “Date_of_Birth", OP_SET, "19531012"); 


rc = DbmQuickUpdate( 
hexp, 
hub, // Update block handle 
bcount); 
‘i Only one row in this case. 
DbmFreeUpdateBlk (hub) ; 
} 
DbmFreeExpression(hexp); 
} 


// Handle to search expression 


// Count of updated rows returned here 


Listing 2. How to update database reflecting correct date of birth. 
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DbmSelect. For example, you may want 
to search the “Genealogy Main Table” 
for all people born between 1800 and 
1850. The search criteria is put together 
in the form of an expression before 
you call DbmSelect. An example is 
shown in Listing 1. 


UPDATING THE TABLE ROWS 

You can choose to update one or more 
columns in each call to DbmUpdate. This 
function uses a search expression like 
the one used by DbmSelect. 

You can update a column by set- 
ting it to a specific value, adding to its 
current value, or subtracting from its 
current value. You can also perform 
search/replace on the value of a string 
column; add or subtract days, months, 
and/or years to a date column; or 
change the case of a column to upper 
or lower case. 

If an update procedure is specified, 
the engine invokes it before updating a 
column’s value. The update procedure 
can choose to continue, make its own 
changes to the column, or bypass the 
operation completely. This mechanism 
allows the programmer to perform up- 
date actions that are not directly sup- 
ported by the database engine. 

The special form of UPDATE_ 
ADD and UPDATE_SUB allows me to 
add or subtract days, months, and years 
to or from a column of type CT_DATE. 

Listing 2 is an example of how to 
update my database to reflect John 
Smith’s correct date of birth. 


CATALOGUING A TABLE 

If you have a table in the proper file 
format (dbASE III for version 1.0), then 
you can incorporate it into the data- 
base by “cataloguing” it with 
DbmCatalogTable. On return from this 
function, you can use the table as if 
you had created and populated it 
yourself. Use function DbmUncatalogTable 
to perform the reverse operation. 


EVENT HANDLING 

The e_Db database engine optionally 
calls back your application when cer- 
tain events occur. Your event handler 
receives a message ID that tells it 
which event took place. Event mes- 
sages are shown in Listing 3. 


IMPORTING AND EXPORTING TEXT 

You can import text from a file into an 
existing table using DbmImportTable. The 
file must consist of lines of text sepa- 
rated by CR-LF combinations. The first 
line of the file must be a table defini- 
tion string similar to the one passed to 
DbmCreateTable. For example, 


Here is a list of e_Db 
functions by category: 


Instance handling functions: 
DbmCreateEngineInstance 
DbmShutdownEngineInstance 


Database handling functions: 
DbmQuer yDb0rvClass 
DbmOpenDatabase 
‘DbmCloseDatabase 
DbmCreateDatabase 
DbmDropDatabase 
-DbmQuer yDbInfo 
-DbmQuer yDbTables 
DbmQuer yDbIndices 
DbmPromoteAccess 
DbmSetCaseSensitivity 
DbmSetRetryParameters 


Table handling functions: 
DbmGetTableHandle 
DbmCatalogTable 
DbmCreateTable 
DbmDropTable 
-DbmExportTable 
-DbmimportTable 
DbmQueryTableInfo 
DbmQueryTableColumns 
DbmQuer yTableIndices 
-DbmUncatalogTable 
DbmWidestTableColumn 














name fstring(10), address fstring(30) CR-LF 
"John Doe", "2659 SE 14th Street" CR-LF 


To export the contents of a table to 
a text file use DbmExportTable. 


LOCKING & UNLOCKING TABLES 
Locking and unlocking of tables is 
handled by the database engine. 
Whenever needed, calls to DbmInsert, 
DbmSelect, DbmDelete, DbmUlpdate, lock the 
table(s), perform the given operation, 
and then unlock the table(s). 


UTILITIES 
Utilities are included to allow you to 





Event symbol 
DBM_NEW_TABLE 
DBM_NEW_INDEX 


DBM_RETRY_APPROVE 


DbmPackTable 
DbmGetTableRowCount 


Search criteria expression 
handling functions: 
DbmCreateExpression 
DbmAddExpressionTerm 
DbmAddStringTerm 
DomAddExpressionParen 


DbmAddLogical0perator 
DbmFreeExpression 


Join handling functions: 
DbmCreateJoin 
DbmAddJoinTerm 


UPDATE handling functions: 
DbmCreateUpdateBlk 
DbmAddUpdateAction 
DomAddUpdateString 

DbmUpdate 

DbmQuickUpdate 

DbmFreeUpdateBlk 

DbmAlLoc 

DbmFree 


INSERT handling functions: 
DbmCreateDS 

DbmCLearDS 

DbmGetColumnWidth 

DbmSetExtCoLumn 

DbmSetStruct 


quickly create databases, tables, in- 
dices, query table contents, update 
columns, and catalog tables. I found 
GENHEAD.EXE a particularly useful 
utility. When given the name of a data- 
base dictionary file (.dbd), it produces 
a header file with all the typedef state- 
ments required to manipulate the rows 
in native C or C++. Another utility 
called GENVB.EXE generates a similar 
file for use with VisualBasic. 


CLOSING THOUGHTS 

I found e_Db a good compromise 
between a simple database library 
package and a complex database sys- 





Description 


Another user added a table to the database 
Another user added an index to a table 


If the internal number of retries is exceeded, the system 


calls your event handler to decide whether to continue or to terminate the opera- 


tion. 


DBM_SELECT_LIMIT 


Whenever a select operation encounters more rows than 


you specified as maximum, this event is sent to your event handler so that it can 
decide how to proceed. DBM_SELECT_ROW. Optionally you can receive a mes- 
sage for each row matched in a call to DbmSelect. 


Table 3. Event message table. 
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Index handling functions: 
DbmCreateIndex 
DbmDropIndex 


SELECT handling functions 
DbmFreeSelect 

DbmFreeSelectRow 
DomQuerySelectCount 
DbmGetSelectStruct 
DbmGetSelectColumn 


DELETE handling functions: 
DbmQuickDelete 


Event handling functions 
DbmSetEventProc 
DbmDefaultEventPro 


Special performance-related 
functions: 

DbmLockTable 

DbmUnlockTable 


Error handling function 
DbmRetrieveString 





tem. It is a database library that does 
most of the work for me while pro- 
viding portability, speed, ease of use, 
and robustness. 


Jake Jacob /s a retired (really!) [BMer who 
began programming when it was called wiring 
contro! panels. He's been invalved with PCs 
since their inception and has taught program- 
ming languages, desktop publishing, graphic 
arts and word processing classes. He is cur- 
rently an independent consultant working in 
desktop publishing. He can be contacted at 
(407) 395-6069 or at CompuServe 76305,2510. 


REFERENCES 


The e_Db product is shipped with 
three manuals: an installation guide, 
programmers’ guide, and a pro- 
grammers reference. A technical doc- 
ument providing additional product 
information is also available. 

All are available from: Simple 
Software Solutions Inc., 2659 SE 14 
ot., Pompano Beach, Fla. 33062. 
Voice: 305-782-8385, fax: 305-782- 
0818. CompuServe 72143,2024, in- 
ternet cportela@gate.net 
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ABRAXAS SOFTWARE INC. Circle No. 130 
PCYACC 5.0 is a complete Language 
Development Environment that generates 
ANSI C and C++ source code from input 
Language Description Grammars for build- 
ing assemblers, compilers, interpreters, 
browsers, and so on. This product generates 
C++ and YACC classes for OS/2 2.0 
Presentation Manager. In addition, PCYACC 
builds systems with full error handling, 
recovery, and reporting. Price: 5995, 

CodeCheck 5.0is a programmable tool for 
managing all C and C++ source code on a 
file or project basis. It is input-compatible 
with all variants of K&R, ANSI C, and C++. 
CodeCheck allows corporate coding and 
project specification standards to be auto- 
mated for compliance validation and will 
identify code that will not port between plat- 
forms. Price: $995. 

Abraxas Software Inc., 5530 SW Kelly, 
Portland, Ore. 97201, (503) 244-5253, fax 
(503) 244-8375. 


ACCESS Circle No. 131 
dSIGN for Windows 2.5 databased publishing 
package allows retailers and distributors to 
create shelf signs, bar code labels, and cus- 
tomer mailings with WYSIWYG, linking 
them to databases using FoxPro 2.5 Data 
Manager and downloading to Portable 
dSIGN /2-32 in-store under OS/2. The prod- 
uct allows printing using PostScript laser 
printers. Price: $995. 

Access, 3131 Western Ave., Ste. 530, 
Seattle, Wash. 98121-1028, (206) 285-4994, fax 
(206) 285-1807. 


ACCUSOFT CORP. Circle No. 132 
AccuSoft Image Format Library 5.0 supports 
raster formats: TIFF, JPEG, PCX, GIF, DIB, 
WPG, BMP, TGA, PICT, EPS, WMF, DCX, 
PCD, IFF, SUN, PSD, ASCII, and 19 more. 





The staff of OS/2 Developer put together this special section to guide you through the various software 
tools specifically for the PowerPC. The products described in this guide are based on surveys sent to 
vendors; they are provided as a service to you and are free to vendors. These listings do not represent an 
endorsement by OS/2 Developer. A/though every effort has been made to ensure accuracy, we do not 
assume any responsibility for error or omission in this section. Contact vendor for availability. 


Tools for the PowerPC 
Buyers Guide 


The product has the ability to import, export, 
convert, compress, scan, display, and print. 
Image processing includes: rotate, invert, 
zoom, pan, scroll, color reduction, edge 
detect, laplacian, thumbnails, and so on. It 
works with any OS/2 language that sup- 
ports DLLs. Price: $1,295. 

Accusoft Corp., 2 Westborough Business 
Pk., Westborough, Mass. 01581, (508) 898- 
2770), fax (508) 898-9662. 


ARITY CORP. Circle No. 133 
Prolog 32 for OS/2 provides power of the 
Arity/Prolog language in addition to the 
superior performance of the 32-bit environ- 
ment. This product eliminates many 
imposed 16-bit environment limitations for 
language and system performances. Price: 
$995. 

Arity Corp., Damon Mill Sq., Concord, 
Mass. 01742, (508) 371-1243, fax (508) 371- 
1487. 


AUTOTESTER INC. Circle No. 134 
AutoTester for OS/2 3.0 is an automated testing 
tool designed specifically for OS/2 PM 
applications. AutoTester builds structured, 
object-oriented, well-documented tests as 
you operate an application. The product sup- 
ports variables and external test case data, 
conditional branching, and text and bitmap 
data comparisons. In addition, it includes a 
menu-driven interface as well as a powerful 
command language for advanced scripting 
needs. Price: contact vendor 

AutoTester Inc., 8150 North Central 
Expwy., Ste. 1300, Dallas, Tex. 75206, (214) 
368-1196, fax (214) 363-2886. 


BENTLY SYSTEMS INC. Circle No. 135 
MicroStation 5.5 is a full-featured 2-D/3-D 
professional computer-aided design product. 
In addition to its consistent, intuitive, graph- 
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ical user interface and flexible command 


structure, the 2-D production drafting tools 
are the force behind MicroStation’s work- 
group-oriented approach. It is capable of 
running programs written in the 
MicroStation development language. Price: 
$3,950. 

Bently Systems Inc., 690 Pennsylvania 
Dr., Exton, Pa. 19341, (610) 458-5000, fax 
(610) 458-1060. 


CAP AUTOMATION Circle No. 136 
CAP Accountant is a DOS-based accounting 
system that can be run on a cash or accrual 
basis and will generate real-time financial 
and accounting reports. In addition to doing 
regular general ledger accounting functions, 
it will also keep track of your checkbook bal- 
ance and allow easy bank reconciliation. 
Price: $495. 

CAP SellWise 95.2 replaces manual work 
with automatic inventory control, product 
re-ordering, serial number tracking, accounts 
receivable, and customer tracking. Sales sta- 
tions continue to operate following any net- 
work failure. Information appears instantly 
with the standard reports for any date range 
without posting, closing periods, batch pro- 
cessing, or manual calculating. SellWise cap- 
tures the information for each sale, inven- 
tory, customer, and vendor, and shares it 
with back-office management in real time. 
Price: $1,495 for a single user. 

CAP Automation, 3737 Ramona, Fort 
Worth, Tex. 76116, (800) 826-5009, fax (817) 
560-8249. 


CIRRUS TECHNOLOGY INC. Circle No. 137 
UniteLite 1.5 is designed for small work- 
groups to reduce storage and handling 
requirements associated with paper files and 
folders. It is an image and photograph stor- 
age and retrieval tool based on the OS/2 
Workplace Shell and OS/2 Warp. UniteLite’s 
capabilities include scanning, viewing, find- 
ing, and printing forms, reports, and other 
key documents. Price: $295. 

Unite CD-Maker 1.3 uses IBM's SOM and 
Workplace Shell technology for creating cus- 
tom CDs. This product takes advantage of 
OS/2’s multithreaded performance to 
increase the speed and reliability of CD- 
ROM creation. Two CD recording methods 
are supported: “bum-on-the-fly” or build a 
virtual CD image file. Both methods produce 
CD-ROMs that conform to the ISO 9660 for- 
mat and can be read from any OS/2 system. 
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Price: $249. 

Cirrus Technology Inc., 5301 Buckeyes- 
town Pike, Frederick, Md. 21701, (301) 698- 
1900, fax (301) 698-1909. 


COMPUWARE CORP. Circle No. 138 
Uniface is a robust development environ- 
ment, which is open and portable. 
Applications built with Uniface have simul- 
taneous read/write access to numerous data- 
base and file management systems, includ- 
ing DB2, Oracle, Sybase, Informix, INGRES, 
and others. A single application runs under 
multiple GUIs and character modes without 
any additional programming. Regardless of 
interface, Uniface applications exploit each 
environment. This product also works with 
several CASE tools, including those from 
Knowledgeware and Intersolv. Uniface has 
been used to build enterprise client/server 
software applications in a wide range of 
industries including financial services, phar- 
maceuticals, telecommunications, govern- 
ment, and manufacturing. Price: contact ven- 
dor. 

Compuware Corp., 31440 Northwestern 
Hwy., Farmington Hills, Mich. 48334-2564, 
(800) 356-3608, fax (810) 737-7119. 


CONTRACCT SYSTEMS CORP. Circle No. 139 
ContrAcct 3.1, a fully integrated contractor 
accounting/job cost management system, is 
designed for contractors. ContrAcct includes 
accounts payable, accounts receivable, cash 
management, equipment, general ledger, 
inventory, job cost, payroll, purchase order, 
and report writer. It is a single entry system 
of source documents with all internal post- 
ings performed automatically. In addition, 
this product supports multiple companies 
and multiple users, and offers custom pro- 
gramming, individual professional training, 
telephone and modem support, and annual 
updates. Price: contact vendor. 

ContrAcct Systems Corp., 208 N. 
Washington St., Naperville, Ill. 60540, (800) 
562-2678, fax (708) 355-8675. 


COPIA INTERNATIONAL Circle No. 140 
Accsys for Paradox 6.0 enables programmers 
to create and/or update Paradox files. It is 
an interface between C or VisualBasic and 
Paradox (through 5.0), providing the pro- 
grammer control over Paradox table files, 
primary, and secondary index files. Accsys 
provides a portable multiplatfom database 
system with a high-level and low-level API 
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for faster application development. 
Price: $495. 

AccSys for xBase 6.0 enables pro- 
grammers to create and/or update 
files of dBASE III, IV, Clipper, and 
FoxPro. It combines the power of 
dBASE with the efficiency of C or 
VisualBasic to create more efficient 
applications. AccSys for xBASE pro- 
vides a portable multiplatform data- 
base system with a high- and low-level 
API for faster application develop- 
ment. Price: 5495. 

Copia International, 1342 Avalon 
Ct., Wheaton, Ill. 60187, (800) 689-8878, 
(708) 665-9841. 


CYGNET PUBLISHING 

TECHNOLOGIES INC. Circle No. 1417 
Scribe Document Production Software 7 
(1750) is cost-effective publishing soft- 
ware designed for the production of 
large and complex documents. 
Producing high-quality output, it inte- 
grates text, graphics, tables, and exter- 
nal data from database management 
systems. Price: $895. 

Cygnet Publishing Technology 
Inc., 355 Sth Ave., Ste. 1515, Pittsburgh, 
Pa. 15222, (412) 471-2070, fax (412) 391- 
F215, 


DST BELVEDERE Circle No. 142 
The Global Portfolio System (GPS) 3.0 is a 
UNIX-based multicurrency portfolio 
accounting and performance measure- 
ment solution for institutional invest- 
ment advisors. GPS supports all trans- 
actions and provides complete 
accounting for all securities and cur- 
rencies. With its rules-based design, 
GPS offers the extensibility to meet the 
demands of new markets as they 
emerge. GPS is a client/server solution 
that has a platform, relational data- 
base, and is graphical user interface 
independent. Price: contact vendor. 

DST Belvedere, 470 Atlantic Ave., 
Boston Mass. 02210, (617) 482-8800, fax 
(617) 482-8878. 


FAIRCOM CORP. Circle No 143 
d-tree Development Tool 3.4A offers 
beginning programmers a bridge to 
the control, flexibility, and portability 
of C development. Experienced pro- 
grammers increase results while main- 
taining low-level flexibility. Features 
include, productive front-end for c- 
tree, complete portable screen handler, 
menu/HELP management, data dic- 
tionary, file-/field-level editing /vali- 
dation, resource swapping, and run 
time control of program resources. 
Price: 5$495-$745. 

FairCom Server 6.04.24 is a high-per- 
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formance, multithreaded, transaction 
processing server. Features include, 
industrial quality transaction process- 
ing, full commit and rollback, interme- 
diate save points and complete log- 
ging, automatic log management, 
restart/disaster recovery, user pass- 
words, access security and on-line 
administration, deadlock detection/ 
resolution, and read/write locks at the 
record/individual key level. Price: 
$295-$3,795. 

FairCcom Corp., 4006 W., 
Broadway, Columbia, Mo. 65203-0100, 
(314) 445-6833, fax (314) 445-9698. 


FELSINA SOFTWARE Circle No. 144 
A-Talk 1.6 is the Microsoft Office 
Compatible telecommunications pack- 
age, which includes, Microsoft Mail, 
ec:Mail, Notes Mail, DDE and Net- 
DDE, VT220, VT100, VT52, Tektronix 
4014, H19, VIDTEX, ANSI, TTY; 
X/Y/ZModem, Kermit, CompuServe 
B+, ASCH; BBS, and chat mode, drag- 
and-drop, history buffer, phone books, 
clipboard, help, over 280 modems, 
script language, editor, and autoscript. 
Microsoft Office’s compatible features 
include toolbar, tooltips, statusbar, and 
advanced help. A-Talk is a certified 
OS/2 Warp compatible by NSTL. 
Price: $79.95, 

Felsina Software, 4440 Finley 
Ave., Ste. 108, Los Angeles, Calif. 
90027, (213) 669-1497, fax (213) 669- 
1893. 


FIRST BYTE INC. Circle No. 145 
ProVoice Tool Kit 2.1 allows program- 
mers to add synthesized speech to 
their applications. The program passes 
text strings to a speech driver, while 
translating the text into audible 
speech. All of the necessary tools and 
examples are provided to manipulate 
the ProVoice speech technology. Price: 
$599, 

First Byte Inc., 19840 Pioneer Ave., 
Torrance, Calif. 90503, (310) 793-0610, 
fax (310) 793-0601. 


FOOTPRINT 
SOFTWARE INC. Circle No. 146 
IBM Works 2.0 is currently included as a 
part of the OS/2 Warp BonusPak. It is 
an integrated productivity package 
offering word processing, spread 
sheets, charting, database, report 
writer, and personal information man- 
agement tools. IBM Works provides 
integration across the modules and 
with the Workplace Shell. Price: con- 
tact vendor. 

Footprint Software Inc., 53 Yonge 
St., Toronto, Ont., Canada, M5E1]3, 
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(416) 860-0477, fax (416) 860-1780. 
IBM CANADA Circle No. 147 
VisualAge C++ for OS/2 Warp 3.0 extends 
IBM‘s programming tools to the 
PowerPC. The tools, including parts- 
based Visual and Data Access 
Builders, IBM Open Class libraries, 
integrated C++ programming tools, 
and robust Direct-To-SOM C/C++ 
compilers produce optimized code and 
are consistent with VisualAge C++ for 
OS/2 and the entire VisualAge C++ 
family. PowerPC code generation sup- 
port, in an upcoming version of 
VisualAge C++ for OS/2, will also 
allow development of both Intel and 
PowerPC applications from a single 
development platform. Price: contact 
vendor. 

IBM Canada, 1150 Eglinton Ave., 
North York, Ont., Canada. M3C1V7, 
(416) 448-2647, fax (416) 448-4414, 


IBM Circle No. 148 
The Developer Connection for OS/2 sub- 
scription can increase productivity by 
providing the most updated tools, pre- 
release software, product demos, and 
information needed on today’s 
medium CDs. An annual subscription 
to The Developer Connection News keeps 
tools and information from becoming 
obsolete. Each year, receive four vol- 
umes including CDs and The Developer 
Connection News, each packed with the 
tools and information you need for 
your Intel and PowerPC OS/2 devel- 
opment efforts. Price: $199. 

The IBM Developer's Toolkit for OS/2 
Warp Connect (PowerPC Edition) will be 
available as part of The Developer 
Connection for OS/2. The toolkit is 
positioned to assist developers of the 
Power Series family in specific applica- 
tions and allow a recompile of existing 
OS/2 applications running on x86 
processors to run on the IBM Power 
Series family. The toolkit includes, 
tools for building programs such as 
linker, archiver, resource compiler, 
object and executable file analysis 
tools; resource editors and build tools; 
SOM compiler and emitters; headers 
and import libraries; online documen- 
tation; code tutorials; and debugging 
aids. Price: $199. 

IBM, 100 N.W. 51st. St., Boca 
Raton, Fla. 33432, (407) 443-5180, fax 
(407) 443-2453. 


ICVERIFY INC. Circle No. 149 
ICVerify 6.5 is a complete PC-compati- 
ble credit authorization software pro- 
gram designed to provide credit card 
authorization, check acceptance, and 
ATM/debit card authorizations with 





menu-driven simplicity. ICVerify can 
operate by itself using a pop-up win- 
dows or can be integrated into other 
application programs. Additional fea- 
tures include: signature capture, mullti- 
ple transactions/ queuing, extensive 
reporting /statistics, address verifica- 
tion, modem sharing, and install- 
ment/recurring processing. Price: 
$349-1,999, 

ICVerify Inc., 473 Roland Wy., 
Oakland, Calif. 94621, (510) 553-7500, 
fax (510) 553-7553. 


IMAGESTAT CORP. Circle No. 150 
ImageCare 2.3, a document manage- 
ment system, is designed with a flexi- 
ble graphical interface. Using drag- 
and-drop techniques, the document 
management capabilities, including 
scanning, printing, faxing, and filing, 
can be accessed. This product fully 
supports the PowerPC under OS/2 as 
well as OS/2 LAN Sever and the IBM 
3995 Optical Library family. Price: con- 
tact vendor. 

ImageStat Corp., 2950 31st St., Ste. 
220, Santa Monica, Calif. 90405, (310) 
392-1100, fax (310) 392-6250. 


INFINITYSYSTEMS 
CONSULTING Circle No. 151 
Infinity is a PC LAN-based policy and 
claims administration system, which 
fully integrates rating, policy issue, 
policy management, claims adminis- 
tration, client management, statistical 
reporting, and accounting utilizing 
IBM’s OS/2 operating environment. 
Price: contact vendor. 

Infinity Systems Consulting, 7500 
Old Georgetown Rd., Ste. 700, Bethes- 
da, Md. 20814, (212) 675-1757, fax (212) 
675-5479. 


KELLER GROUP INC. Circle No. 152 
Fax Client /Server API Toolkit 2.1 pro- 
vides client/server fax services to 
applications on OS/2. Supported fax 
hardware includes fax modems, 
Mwave, SatisFAXtion, Brooktrout, 
GammaFax, and others. The API 
works with FaxWorks for OS/2, 
FaxPort for OS/2, and other OS/2 fax 
software products in any standalone, 
LAN, or multiline configuration. Price: 
$995. 

Fax Printer Driver Toolkit 2.1 facili- 
tates writing applications that crate 
and send fax documents. The printer 
driver can be used from REXX, DOS, 
Windows, 16-bit OS/2, and 32-bit 
OS/2 programs. The printer driver 
works with FaxWorks for OS/2 and 
FaxPort for OS/2 in any standalone, 
LAN, or multiline configuration. Price: 
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$295. 

Keller Group Inc., 8600 Jewel Ave. 
N., Stillwater, Minn. 55082-9351, 
(612)429-7273, fax (612) 653-1987 or 
(800) 329-3293. 


KNOWLEDGE 

DYNAMICS CORP. Circle No. 153 
winstall Multi-Platform 4.0 is an installa- 
tion toolkit including distribution disk 
builder, full error handling capabili- 
ties, system file editor, one .EXE for 
both DOS and Windows, full C source 
code, no royalties, and a 30-day guar- 
antee. Price: $499.95. 

Install Professional 3.3 is a profes- 
sional installation toolkit for MS-DOS 
or OS/2. Install features include distri- 
bution disk builder, full errror han- 
dling capabilities, system file editor, 
full C source code, no royalties, and a 
30-day guarantee. Price: $399.95. 

Knowledge Dynamics Corp., P.O. 
Box 780068, San Antonio, Tex. 78278, 
(210) 979-9424, fax (210) 979-9004. 


LOGOS SYSTEMS INC. Circle No. 154 
AmbuQual Ambulatory Quality Assess- 
ment and Quality Management System 
6.1.1 focuses on issues that have the 
potential to impact the quality of 
healthcare offered to patients under 
the new health programs proposed by 
the executive and congressional 
branch of the U.S. Government. The 
software measures provider/staff per- 
formance; continuity of care; enhances 
the quality of patient care; minimizes 
patient risk; and measures patient 
compliance and organization perfor- 
mance. Price: contact vendor. 

Logos Systems Inc., 8303 South- 
west Fwy., Ste. 500, Houston, Tex. 
77074, (713) 777-8229, fax (713) 777- 
9512. 


MACROMEDIA Circle No. 155 
Director 4.0 for OS/2 facilitates the 
combining of text, graphics, animation, 
sound, digital video, and interactivity 
to create multimedia productions. 
Director will produce corporate pre- 
sentation; entertainment; and educa- 
tional CD-ROM titles, simulations and 
visualization; kiosks; digital publica- 
tions; electronic reference materials; 
and software demo disks. Price: $1,195. 

Macromedia, 600 Townsend St., 
San Francisco, Calif. 94103, (415) 252- 
2000, fax (415) 626-0554. 


MICROEDGE INC. Circle No. 156 
Visual SlickEdit 1.7 features CUA, Brief, 
Emacs, and VI emulations. This editor 
will facilitate programming with its 
project management, SmartPast, syn- 
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tax color-coding, and built-in dialog 
editor. There is a 30-day money-back 
guarantee. Price: $295. 

MicroEdge Inc., P.O. Box 18038, 
Raleigh, N.C. 27619-8038, (800) 934- 
EDIT, fax (919) 831-0101. 


NETWORK 
TELEMETRICS INC. Circle No. 157 
Proview-SNA 1.4 software monitors 
response time and availability parame- 
ters on complex, heterogeneous net- 
works. It generates active traffic from 
LAN PC workstations to SNA hosts 
and network file servers. It then mea- 
sures the end-to-end delay users are 
actually receiving across the network, 
Network-wide results are forwarded 
to a central management station where 
data is stored in a DB2/2 database. 
Charts and tabular reports of real-time 
and historical data are produced to 
verify service level agreements and 
identify performance trends. Price: 
$25,000. 

Network Telemetrics Inc., 30125 
Agoura Hills, Calif. 91301, (818) 597- 
7900, fax (818) 597-7929. 


ON-LINE DATA Circle No. 158 
OnCmd xBase for 0S/2 harnesses the 
power and the speed of OS/2, 
enabling you to develop new or 
migrate existing applications from 
dBASE, FoxPro, or Clipper to native 
32-bit GUI applications environment. 
It comes with screen painter, report 
writer, DLL/DDE support, 350+ func- 
tions/commands and is client/server 
ready. Unlimited run time and server 
add-on licensing available. Price: $249. 

On-Line Data, 5 Hill St., 
Kitchener, Ont, Canada. N263X4, (519) 
579-3930, fax (519) 579-2130. 


PEERLOGIC INC. Circle No. 159 
Pipes Platform 3.5 message-oriented 
middleware provides communications 
services for distributing applications 
across multiple operating systems, 
hardware platforms, and mixed net- 
works. These services include, asyn- 
chronous, process-to-process messag- 
ing; dynamic name series; session 
management services; and cross-plat- 
form and multiprotocol support. Pipes 
Platform’s flexible communications 
system facilitates developing, distrib- 
uting, and maintaining multitier, dis- 
tributed applications. Price: $200. 
PeerLogic Inc., 555 DeHaro St., 
San Francisco, Calif. 94107-2348, (800) 
PEER-601, fax (415) 626-4710. 


PEGASUS DISK 


TECHNOLOGIES INC. Circle No. 160 
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Pegasus Optical File System 2.3 is a trans- 
parent file and volume management 
system for optical drives and jukeboxes 
under IBM OS/2 2.x and OS/2 Warp. 
Optical drives and jukeboxes appear. as 
standard storage devices. This product 


provides a common file system format 
on optical media that is transportable 


across operating-system platforms. The 
software tracks optical volumes stored 
online, nearline, or offline documents. 
Price: contact vendor. 

Pegasus Disk Technologies Inc., 
1600 S. Main St., Ste. 110, Walnut 
Creek, Calif, 94598, (510) 938-5340, fax 
(510) 938-5341. 


PROCOL INC. Circle No. 161 
Procol RDBMP 4GL 6.0 is ideal for all 
phases of application development, as 
the product is designed to be portable, 
coherent, compact, and user-friendly. 
Procol’s nonprocedural language 
enable 100% of development require- 
ments and offers many advanced fea- 
tures. Price: starting at $950. 

Procol Inc., 5995 Gouin Blvd. W., 
Ste. 300, Montreal, Que, Canada. H4] 
2P8. (514) 336-8551, fax (514) 336-8565. 


QUANT TRADING INC. Circle No. 162 
Sector Trading System 2.0 is a real-time, 
fixed-income, front-office system used 
in trading treasury, municipal, sover- 
eign and corporate debt markets. An 
extremely powerful and customizable 
object-oriented application, Sector pro- 
vides real-time security pricing mod- 
els, analytics, risk analysis, trade-entry, 
and P&L in an intuitive graphical-user 
environment. Price: contact vendor. 

Quant Trading Inc., 100 Prospect 
St., Stamford, Conn. 06901, (203) 357- 
1919, fax (203) 6119. 


RAIMA CORP. Circle No. 163 
Raima Database Manager 4.0 is a data- 
base engine for C and C++ application 
development providing a low-level C- 
API library with over 200 functions for 
database control. The combined rela- 
tional and network database model 
features allow modeling of complex, 
real-world database designs with 
high-performance record access. 
Referential integrity is supported at 
the DDL level. It includes support for 
transaction tracking, logging, and 
automatic recovery. In addition, it 
supports all leading OS and comput- 
ing environments in single- or multi- 
user configurations.Price: $595 and 
up. 

Raima Object Manager 3.0 is a class 
library that allows use of Velocis 
Database Server and Raima Database 
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Manager as an OODBMS,. ROM 
encapsulates object storage and data- 
base navigation into C++ class defini- 
tions to provide a consistent object- 
oriented, interface to Raima databases. 
The library adds persistence to any 
C++ object, object identity, class or 
type hierarchies, container classes, 
safe type checking, VLT, BLOB, 
Referential Integrity, server exten- 
sions, and so on. Price: $495 and up. 

Raima Corp., 1605 NW Sam- 
mamish Rd., Ste. 200, Issaquah, Wash. 
98027, (206) 557-0200, fax (206) 557- 
5200. 


RHINTEK COMPUTER 
ENGINEERING INC. Circle No. 164 
Rhino Com 1.5 is developed for OS/2's 
Presentation Manager. It is a general 
purpose, industrial strength commu- 
nications package emphasizing relia- 
bility, versatility, and ease-of-use. 
RhinoCom is multithreaded, can han- 
dle multisessions, and contains multi- 
media sounds. This product also fea- 
tures advanced workplace Shell 
technology, REXX scripting, and 
macro capabilities. Price: $199. 
Rhintek Computer Engineering 
Inc., 8835-C Columbia 100 Pkwy,., 
Columbia, Md. 21045, (410) 730-2575, 
fax (410) 730-5960. 


SUNDIAL 

SYSTEMS CORP. Circle No. 165 
Relish 2.2, time management software 
for workgroups and individuals, con- 
tains calendars, to dos, and a phone 
book that is integrated for reliability. 
In addition, this product includes 
desktop objects for common and cus- 
tomizable views, keyword searching, 
and drag-and-drop convenience. 
Relish runs on the PowerPC and 
mixed Intel-PowerPC environments. 
Price: contact vendor. 

Sundial Systems Corp., 909 
Electric Ave., Ste. 204, Seal Beach, 
Calif. 90740, (310) 596-5121, fax (310) 
598-9851. 


SPG INC. Circle No. 166 
ColorWorks for OS/2 PowerPC 1.0 is a 32- 
bit multitasking, multithreaded graph- 
ics paint image-processing, and 
image-editing software. ColorWorks 
eliminates the hourglass cursor, can 
save up to 90% of the memory usually 
needed to edit images, and can spread 
work across up to 64 processors-for 
workstation performance and beyond 
on a PC. Price: contact vendor. 

SPG Inc., 155505 Bull Run Rd., 
Ste. 303, Miami Lakes, Fla. 33014, (305) 
823-6602, fax (305) 823-2753. 


The staff of OS/2 Developer put together this special section to guide you through the various software 
tools specifically for database development. The products described in this guide are based on surveys 
sent to vendors; they are provided as a service to you and are free to vendors. These listings do not 
represent an endorsement by OS/2 Developer. A/though every effort has been made to ensure accuracy, 


we do not assume any responsibility for error or omission in this section. 


Database Development ‘Tools 


Buyers Guide 


ACUCOBOL INC. Circle No. 101 
Acu4GL provides seamless access to Informix, 
Oracle, and Sybase databases from new or 
existing applications written in AcuCOBOL- 
85 by generating SOL queries. With Acu4GL, 
users can benefit from RDBMS technology 
without learning SQL, rewriting applica- 
tions, or retraining. Applications need to be 
compiled only once. This product eliminates 
the need to add embedded SQL to existing 
COBOL programs. Instead, industry-stan- 
dard COBOL I/O verbs generate SQL to 
access the database. This bidirectional infor- 
mation exchange allows users to utilize 
fourth generation report writers and query 
tools while retaining the use of their COBOL 
application. Price: contact vendor. 

Acucobol-85 is a portable COBOL com- 
piler for microcomputers, minicomputers, 
and mainframes available. It produces com- 
pact, yet optimized machine-independent 
object code and runs on over 600 different 
platforms without recompiling. Acucobol-85 
is source code compatible with RM/COBOL, 
VAX COBOL and DG-ICOBOL and includes 
its own user-replaceable file system. Price: 
contact vendor. 

Acucobol Inc., 7950 Silverton Ave., Ste. 
201, San Diego, Calif. 92426-6344, (619) 689- 
7220 or (800) COBOL85, fax (617) 566-3071. 


APICAL SOFTWARE INC. Circle No. 102 
GpfRexx 1.0 is an OS/2 PM visual develop- 
ment tool that makes possible the use of 
REXX for implementation of custom logic. It 
is suitable for individuals and professional 
programmers, and offers all the power nec- 
essary to create full-functioned applications 
and/or working prototypes. There are no 


royalties on GpfRexx generated applications. 
Its design files are compatible with Gpf 2.1, 
permitting designs or prototypes to be 
ported to C/C++ without having to recreate 
the GUI, GUI management logic, or Help. 
Price: $199. 

Gpf 2.1, is a visual GUI design environ- 
ment that is not industry specific, which 
offers full support for OS/2 2.x and OS/2 
1.3x, a CUA’91 compliant GUI, and Gpf gen- 
erates C or C++ source as well as Help 
source and all ancillary files to build the 
design. Gpf automatically generates all the 
logic to manage the entire user interface, 
leaving the designer free to concentrate on 
custom application logic. Price: $1,295, 

Apical Software Inc., 40 Falls Rd., P.O. 
Box 432, Moodus, Conn. 06469-0432, (203) 
873-3300, fax (203) 873-3302. 


BACHMAN INFORMATION 

SYSTEMS INC. Circle No. 103 
Bachman/Analyst 4.2 is a comprehensive and 
scalable business-modeling solution for 
today’s application development organiza- 
tions. It supports a range of platform-inde- 
pendent modeling tasks, ranging from high- 
level business data and process modeling 
through detailed application modeling. The 
Bachman/ Analyst enables companies to 
build flexible, in-depth models that accu- 
rately reflect business requirements and 
become long-term reusable assets for the 
organization as it grows and changes. Price: 
$10,000 per seat. 

Bachman/DBA for DB2 4.2 provides a 
graphical interface for rapid database design, 
describes database contents completely, and 
is fully integrated with tools for DB2 data- 
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base design. This product helps design 
and implement databases for a variety 
of other relational databases including 
Sybase and Microsoft SQL Server, 
Oracle, Informix, Ingres, Rdb, IBM's 
DB2/2, and OS/2 Extended Services 
Database Manager. Price: $15,000. 

Bachman Information Systems, 8 
New England Executive Pk., Bur- 
lington, Mass. 01803, (617) 273-9003, 
fax (617)229-9904., 


BRIGHTWARE INC. Circle No. 104 
ART*Enterprise for OS/2 1.0 R1 is a tool 
for building intelligent software appli- 
cations that integrate databases, docu- 
ments, and business policies. It pro- 
vides business object modeling, 
business rules that automate corporate 
policies, and case-based retrieval 
(CBR) technology, which permits nat- 
ural language retrieval of objects. A 
supported DBMS includes DB/2, 
Oracle, Sybase, SOL Server, and others 
via Q+E. ART*Enterprise applications 
are fully portable across Windows, 
OS/2, and Unix. Price: $7,995. 

Brightware Inc., 101 Rowland 
Wy., Ste. 310, Novato, Calif. 94945, 
(800) 532-2890, (415) 899-9070, fax (415) 
899-9080, 


CONSYST SQL 
DESIGN INC. Circle No. 105 
SQL Design 2.1 is a rapid client/server 
application development generator for 
SOL databases, and it offers database- 
independent cross-platform solutions. 
This 4GL tool uses a graphical user 
interface to create powerful, user- 
friendly programs cost-effectively. An 
efficient productivity tool for the 
development and maintenance of 
applications, SQL Design enables pro- 
grammers to generate systems easily 
and in less time. Price: $250. 

Consyst SQL Inc., 15 Mont-Royal 
W., Ste. 120, Montreal, Que, Canada. 
H2T 2R9, (514) 849-7431, fax (514) 849- 
8125. 


DSOFT 

DEVELOPMENT INC. Circle No. 106 
dbfLIB Programmer's Library 2.04 is a 
C/C++ programmer’s library for 
accessing dBASE data files and 
indexes. Included are royalty-free 
DLLs for Windows, Windows NT, and 
OS/2, Additional support for DOS is 
also included. dbfLIB provides a con- 
sistent set of APIs across DOS, 
Windows, NT, and OS/2 platforms. 


This allows development of applica- 
tions that can share dBASE programs 
currently in use, in addition to other 
programs that use dBASE files. This 
can all be done without migrating 
megabytes of dBASE files to another 
database environment. Price: $195. 

dbfREXX for OS/2 2.04 provides 
dBASE file access from your OS/2 
REXX programs. Works with inter- 
preted REXX or many of the popular 
REXX compilers. dbfREXX provides 
simple, affordable database manage- 
ment to your REXX programs. As a 
migration tool, many corporate devel- 
opers use dbfREXX to move data from 
the mainframe to the PC environment 
for use as dBASE files. Price: $99. 

dSOFT Development Inc., 4710 
Innsbruck Dr., Houston, Tex. 77066, 
phone/ fax: (713) 537-0318 


HILBERT COMPUTING Circle No. 107 
Chron 4.0 is a 32-bit multithreaded PM 
application that will schedule OS/2, 
DOS, or Windows programs running 
under OS/2 at a selected time at 
selected intervals. Chron uses REXX as 
a macro language to extended the base 
scheduling options. Price: $99. 

Hilbert Computing, 1022 N. 
Cooper Ct., Olathe, Kans. 66061, (913) 
780-5051, fax (913) 829-2450. 


INTELLIGENT 
OBJECTS CORP. Circle No. 108 
SQL Objects 2.2 will supply cross-plat- 
form, multi-database development 
tools. Encapsulated are all of the popu- 
lar databases into a C++ class library. 
SOL Objects supplies drivers for 
Oracle, Sybase, SQL Server, SQL 
Sybase, Watcom SQL, Informix, 
DB2/6000, DB2/2, DDCS/2, Netware 
SOL, Btrieve, and so on. Cross-plat- 
form development is possible. Price: 
$699. 

Intelligent Objects Corp., 47 
Stonewall St., Cartersville, Calif. 30120, 
(404) 382-6585, fax (404) 382-6374. 


MACHINE INDEPENDENT 

SOFTWARE CORP. Circle No. 109 
COL++ 8.0 provides a single user or 
client/server SOL database engine 
including complete C++ source code. 
COL++ is usable in any environment 
where a C++ compiler is available 
meeting the proposed ANSI C++ spec- 
ification (templates not required). 
COL++ implements ANSI SOL 1989 


with ODBC extensions and provides 
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an embedded interface as well as an 
ODBC driver. Price: $495 for a single- 
user, $995 for client/server. 

Machine Independent Software 
Corp., 1819 Ridgemont, Columbia, Mo. 
65203, (800) 823-8672, (314) 446-4242, 
fax (314) 446-4243. 


MERCURY 
INTERACTIVE Circle No. 110 
WinRunner for OS/2 3.5 provides produc- 
tive solutions for automated testing of 
GUI client applications. It tests the 
application automatically with speed, 
accuracy, and repeatability, thereby 
greatly reducing testing time. Price: 
$4,995. 

Mercury Interactive, 470 Potrero 
Ave., Sunnyvale, Calif. 94086, (408) 
523-9273, (408) 523-9911. 


OBJECT DESIGN INC. Circle No. 111 
ObjectStore 4.0 is a high-performance 
database for storing complex data 
structures and nonrecord-oriented 
information in heterogeneous client / 
server environments. ObjectStore fea- 
tures distribution and transaction 
management for concurrent access to 
objects among members of a work- 
group. It also offers state-of-the-art 
database functions such as data 
integrity, version control, query pro- 
cessing, and a complete multi- 
client/multi-server architecture. Price: 
contact vendor. 

Object Design Inc., 25 Mall Rd., 
Burlington, Mass. 01803, (617) 674- 
5162, fax (617) 674-5262. 


ON-LINE DATA Circle No. 112 
OnCmd xBase for OS/2 1.1.5 harnesses the 
power and the speed of OS/2, 
enabling you to develop new or 
migrate existing applications from 
dBASE, FoxPro, or Clipper to native 
32-bit GUI application environments. 
It comes with screen painter, report 
writer, DLL/DDE support, 350+ func- 
tions/commands, and is client/server 
ready. Unlimited run time and server 
add-on licensing is available. Price: 
$249. 

On-Line Data, 5 Hill St., 
Kitchener, Ont, Canada. N263X4, (519) 
579-3930, fax (519) 579-2130. 


PARCPLACE 

SYSTEMS INC. Circle No. 113 
VisualWorks 2.0 is a powerful client and 
server tool for building portable appli- 
cations using object-oriented technol- 





ogy. A Database Application Creator is 
included for rapid application devel- 
opment. Applications developed are 
instantly portable across the enterprise 
and can have their functionality dis- 
tributed between both client and 
servers. Price: $2,995. 

VisualWorks Report Writer, an 
extension to the VisualWorks product 
line, is a comprehensive query and 
report-generation tool for VisualWorks 
developers and users. Fully integrated 
with VisualWorks, this client/server 
development tool builds portable 
applications with object-oriented tech- 
nology and provides point-and-click 
access to a number of reporting capa- 
bilities. With its spreadsheet-like 
macro language, ReportWriter is intu- 
itive enough for users, yet powerful 
enough for programmers. Price: $375. 

ParcPlace Systems, Inc., 999 East 
Arques Ave., Sunnyvale, Calif. 94086- 
4593, (800) 759-7272, (408) 481-9090, 
fax (408) 481-9095. 


POET SOFTWARE CORP. _ Circle No. 114 
POET 3.0 is a C++ Object DBMS that 
supports encapsulation, inheritance, 
and polymorphism. It is available for 
14 different operating systems and 
comes as single-user or client/server 
version. POET 3.0 features include 
OLE and ODBC support, schema ver- 
sioning, check-in/check-out, online 
backup, as well as a developer work- 
bench that includes class and object 
browsers. Price: contact vendor. 

POET Software Corp., 999 Baker 
Wy., Ste. 100, San Mateo, Calif. 94404, 
(415) 286-4640, fax (415) 286-4630. 


PROGRAMART CORP. Circle No. 115 
APMpower Application Performance 
Analysis System is used to analyze MVS 
application performance data. 
Operating with Programart’s STROBE 
Application Performance Mea- 
surement System, APMpower enables 
developers to interactively manage 
measurement sessions of MVS applica- 
tions and to analyze their results using 
OS/2 workstations. Analytical aids, 
including application performance 
hints, online help, a database of mod- 
ule descriptions, and guided analysis 
methods empower developers, as well 
as technical staff to resolve application 
performance issues. The SQL analysis 
feature helps pinpoint SQL inefficien- 
cies by suggesting specific database 
definition and coding changes that 


could improve the performance of 
DB2 applications. Price: contact ven- 
dor. 

Programart Corp., 124 Mt. 
Auburn 5St., Cambridge, Mass. 02138, 
(617) 661-3020, fax (617) 498-4010. 


SAS INSTITUTE INC. Circle No. 116 
SAS System 6.0 is an integrated suite of 
information delivery software for 
business decision making. It provides 
organizations with tools to access, 
manage, analyze, and present data 
within an applications development 
environment. Capabilities include EIS, 
data warehousing, client/server com- 
puting, database access, applications 
development, graphics, data analysis, 
report writing, quality improvement, 
project management, computer perfor- 
mance evaluation, and decision sup- 
port. Price: $985. 

SAS Institute Inc., SAS Campus 
Dr., Cary, N.C. 27513, (919) 677-8000, 
fax (919) 677-8123. 


SOFTWARE AG Circle No. 117 
Natural 2.1.3.4 is a cross-platform 
fourth-generation language with the 
ability to support text-based or GUI 
development. Price: $900-$1,495. 

Software AG, 11190 Sunrise 
Valley Dr., Reston, Va. 22190, (703) 
391-6981, fax (703) 391-8290. 


XDB SYSTEMS INC. Circle No. 118 
XDB Workbench 4.0 enables mainframe 
DB2 development and maintenance to 
be off loaded to less-costly, more pro- 
ductive platforms such as PCs and 
LANs. Providing programmers with a 
DB2 equivalent environment to 
develop, test, and execute complete 
DB2 application on a desktop, XDB 
Workbench consists of a fully DB2 
compatible database engine, a COBOL 
or PL/1 precompiler, and a suite of 
development and administrative tools. 
Price: $1,500. 

XDB Server 4.0 is a fully DB2 com- 
patible database system that brings 
the power mainframe database sys- 
tems to client/server platforms. XDB 
Server can be used as a repository for 
host-targeted development and as a 
production platform for running DSS 
or OLTP applications. XDB Server is 
currently available for OS/2. Price: 
contact vendor. 

XDB Systems Inc., 9861 Broken 
Land Parkway, Columbia, Md. 21046, 
(410) 312-9300, fax (410) 312-9505. 
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Send text messages to pagers 
directly from OS/2! 


e Easy-to-use workplace shell application 

* Includes a command line interface 

¢ You can 'page-enable’ your applications! 
¢ 32-bit, SOM-based code - Only $79 


REXX + dBase = RexxBase i 


The dBase Database Access For REXX 


© Works with DBF, DBT, NDX and MDx files. 

© Supports dBase Ill and IV file formats. 

© Uses standard REXX API function calls. 

© Comes with a GUI Front-End for Database Maintenance. 


Find the s ion RXBAS203,ZIP favorite BBS 


Use it with VisPro/Rexx,VX Rexx and GpfRexx 
American Coders, Ltd. Post Office Box 97462 Raleigh, NC USA 27624 
(919) 846-2014 


Internet: joe@usacoder.rtp.nc.us CIS: 74150,2370 
Only $95.00 + shipping & handling 


Circle Reader Service Number 22 


TCPAP for OS/2° 


Our customers say our tcp/ip 
is the best because 
i's faster, more complete, 
and reliable. 
Find out for yourself! 


Supported: a// released versions of OS/2 
including 32bit API for 2.x and above; 
SLIP and/or PPP on COM1 and/or COM2; 
Ethernet; Token Ring; ARCNet; NDIS and ODI 


(800) OS2-TCP2 


Essex Systems, Inc. 
One Central Street, Middleton, MA 01949 


A Dan Lanciani Product 


TCP/2 is a Trademark of DLD consulting. All other products and trademarks are the property of 
their ownets. TCP/2 is Based in part on work done by the University of California Berkeley, 
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The easiest to use, most powerful 32 bit OS/2 PM IPF Language Editor... 


New! IPF Editor 2.0 


+ Designed for intuitive use by anyone 

+ Supports all IPF Tags, with simple index creation, easy 
multiple-window creation, and drag-and-drop panel ordering 

+ Generate C program and Resource source 

to add help to applications in minutes Orders: 

* Import WordPerfect, Describe and RTF 1-800-IPF-7622 
« Preview IPF output without compiling Information: (360)428-5025 
* Create all hypertext links automatically on compuserve at 

* Sound Support and Spell Check 7OCLO 4426 

- Complete on-line help and documentation | Perez Computing Services 


. . aa Ne 4725 Monte Vista Place 
+ Optional multi-user nework version Mt Vernon, WA 98273 
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ChipChat® Wireless Communicator 
ChipChat-Cawthon Software 
Dearborn, Michigan USA & Fukuoka Japan 
Phone 313-565-4000 Fax 313-565-4001 
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FAX Developer Tools 


From the developers of FaxWorks for OS/2 
Client/Server API and Printer Driver Toolkits 


Support for LANs, up to 96 lines per CPU, 
and all popular fax hardware 


Keller Group Inc. 


Voice: (612) 429-7273 Fax: (800) 329-3293 
Email: kgroup @ibm.net Fax: (612) 653-1987 


Faxworks is a trademark of Global Village Communication. 
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Opt-Tech Sort/Merge 
High Performance Sort/Merge/Select Utility 


Use as a stand-alone utility or call as a Subroutine. Many 
features including unlimited file size, multiple keys, record 
selection, duplicate elimination, summing and more! 


Call for free brochure §Opt-TechData Processing 
P.O. Box 678 


Available for: Zephyr Cove, NV 89448 
OS/2 or Unix $249 Phone (702) 588-3737 
DOS or Windows $149 Fax (702) 588-7576 
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JOB SCHEDULING SERVER 


OS/2 PM 32-bit advanced job scheduler for NOVELL 
and IBM LANs. Schedules multiple OS /2, DOS, and 
Windows jobs for concurrent execution on specified or 
auto selected LAN nodes. Conditional job scheduling 
(depends on files and other jobs return codes), security, 
sophisticated calendar, job logging, priority, user APIs, 
job recovery, periodic scheduling, and much more. 
Microwork, Inc. 


Phone: (708) 940-8979 Fax: (708) 940-8979 








Network Remote Control And Monitoring 
Help Desks Automated Agent paid 


PM/Pirate 


Named Pipes 
TCP/IP 
Lowest network load 


Record and Playback ana rs ee’ 
All PM Video Modes bth shed 
No Special Drivers ; 

FAST! 

Automated Cycling 


Manager Development and 
$89.00 + san (800) 701 "7205 
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Jagre SmartLink and Lotus Notes: 





A Winning Combination! 


In today’s computer world, communicating effectively and quickly could 
—— be the difference between your company being a dead company or being a 
}quick company. 


Using Lotus Notes within your company, gives your company the ammu- 
nition it needs to be a quick company. 


Video =| Jagre SmartLink is a set of Lotus Notes-enabled tools grouped together 
in one place to empower your IBM OS/2-based desktop applications to 
communciate effectively and quickly with Lotus Notes for Document 

Help —_— | Management, E-mail, Fax, Pager, OCR, Voice, Video, and User-based 
Agents to gets tasks done quickly. 


With Jagre SmartLink, the powerful features of Lotus Notes are now a button 
click away! 


Click on any Jagre SmartLink tool for instant access to Lotus Notes. Now, 
you can use Lotus Notes and the Lotus Notes Companion Products with your 
desktop applications to communicate quickly with someone down the hall or 
across the world! 


Now, your ammunition arsenal is complete with Jagre SmartLink and their 
arsenals are not!! 


| Jagre KWVTTIT a 


For a free demonstration copy of Jagre SmartLink to discover how it can 
help your company be a quick company, not a dead company, call or 
write Jagre, Inc. at (617)424-8302, 102 Gainsborough St. #202E Boston, 


PAA Cel iS. Circle Reader Service Number 31 


Jagre SmartLink 


Vutroducing, . , 
he OS/2 DEVELOPER KtviEs 
and Sewices Guide 


Each issue of OS/2 Developer will now feature this 


special advertising section. 
Costs for an 1/8 page ad range from $350-$450 
Costs for a 1/4 page ad range from $600-$900 


Call For Detadka: 
Moristin Morgan 
212-626-249S85 








TRACK " em DOWN!” 
MIRYAC K Track Customize: 


« Bugs, Change Requests * Reports 
* Projects, Code Changes * Queries 
* Customer Calls and more * Forms & fields 


| Automatic Notification: Nothing falls through the cracks 

- Integration with Version Control: Link files to bugs & bugs to files 
Multiple Linked Databases: Track bugs, customers and more 
| Industry Standard Databases: Access from other applications 


“ sorFRONT FREE working DEMO! 


Software Inc. 1-800-763-3766 / 408.263.2703 
238 S. Hillview Drive, Milpitas, CA 95035 Fax: 408.263. 7452 
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Developer’s Business Graphics Toolkit 


® High-level APIs ® Dynamic Link Library 
® Tactile feedback ® Positive/negative data 

® Real-time charting ® Printer/metafile support 
® 16-bit and 32-bit @ 25+ chart types 


The Crossley Group 
P.O. Box 921759 
Norcross, GA 30092 
USA (404) 751-3703 
Int’! 44-932-844-281 
(demo available) 


DESIGNERS * DEVELOPERS « ARCHITECTS 
Since 1979 Spectrum Concepts has enabled its clients to 


Object-Oriented 
GITINEATIA AMEE effectively meet their business objectives by providing leading- 
edge information technology consulting expertise. The contin- | 
ued success of our rapidly expanding and highly skilled 
consulting team has created new opportunities for talented 
professionals with the following skills: 


* 05/2 GUI * C++, OOD/OOP 


Contact: Karin Lundgren (212) 791-4800 x250 Pax: (212) 791-5639 
Compuserve: 74674,3571 Intemet: spectrum@pipeline.com and/or mail resume to: 
Spectrum Concepts 150 Broadway, Suite 600, Dept. 0S2, NY, NY 10038 
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New Products for OS/2 


C-Vision 4.0. This set of tools allows programmers to 
analyze, understand, document, and maintain C and 
C++ source code. The package consists of four main 
components: a cross-referencer, a diagrammer for 
function-call graphs and class hierarchies, a source 
code reformatter, and an intelligent source code lister. 
The cross-referencer produces a listing of symbols 
enhanced with usage and type information, while the 
tree diagrammer provides numerous output formats 
for different views of your code. The C-Vision refor- 
matter provides for flexible indentation control, 
including independent positioning of curly braces, 
nested preprocessor statements, case/default state- 
ments, and labels. 


Gimpel Software Circle No.180 
Phone: (610) 584-4261, Fax: (610) 584-4266 


CAPWatch 1.0. Creative Assistance Software announces 
the release of CapWatch 1.0, a new addition to its line 
of OS/2 LAN Server utilities. CapWatch is designed to 
meet the need of LAN Server administrators, particu- 
larly those using LAN Server Entry to track server uti- 
lization against configured capacity parameters. In 
addition, this product provides real-time graphing of 
the utilization, logging of the data, graph capture, and 
re-display and configurable alarm and alert levels. The 
program may be operated locally on the server being 
monitored without generating network traffic, or 
remotely across the LAN from any OS/2 workstation. 


Creative Assistance Software Circle No. 181 
Phone: (704) 544-0001, Fax: (704) 543-6366 


BridgeWare. The BridgeWare family of products is the 
first suite of development and run time tools to pro- 
vide access from GUI fourth-generation languages, 
such as Powerbuilder and VisualBasic, to Micro Focus 
COBOL, and CICS applications. This product gener- 
ates a complete interface from 4GL applications to 
COBOL with no manual coding, rewriting, or retesting 
required. It extends 4GL client/server applications 
with true multitasking, server-based business logic for 
development and deployment on a wide range of 
environments. The BridgeWare family of products 
includes Micro Focus DeskTop BridgeWare and the 


Micro Focus BridgeWare Server Enabling Kit, both 
suited for rehosting and partitioning COBOL and 
CICS applications for reuse within a client/server 
architecture. 


Micro Focus Circle No. 182 
Phone: (415) 856-4161, Fax: (415) 856-6134 


Gui-Kit 1.1. This cross-platform GUI toolkit for C and 
C++ simplifies the development of GUI-based applica- 
tions. Gui-Kit provides an intuitive object-oriented 
programming environment for C or C++. 


Visual Systems Corp. Circle No. 183 
Phone: (612) 434-6382, Fax: (612) 434-6538 


LinkWiz. This product makes file transfers fast with 
graphical interfaces that operate under OS/2 2.1, OS/2 
Warp, and OS/2 Warp Connect. Operating across plat- 
forms and in multiple environments, LinkWiz trans- 
fers files from one computer to another. The utility 
software also features file and disk management capa- 
bilities and provides high-speed data-transfer with 
build-in error correction, moving up to 8 MB a minute 
over special parallel and serial cables that come with 
the software. 


PCX Circle No, 184 
Phone: (619) 481-6300, Fax: (619) 481-6474 


OOMetric 2.0. This object-oriented metrics tool now cal- 
culates and reports on over two dozen object-oriented 
metrics for class, size, class inheritance, class internals, 
project concerns, method size, method internals, and 
method externals. Both project and design metrics are 
evaluated. Design metrics cover all aspects of both the 
quality of the object model and the most efficient 
implementation of its architecture. Project metrics han- 
dles administrative concerns, estimating and reporting 
on scheduling and staffing during the development 
process. OOMetric is a standalone program with 
probes for a variety of popular Smalltalk dialects. 


Hatteras Software Circle No. 185 
Phone: (919) 319-3816, Fax: (919) 319-3877 
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No matter how they misspell it, it’s still not 
portability. At Zinc, we understand that porting 
the last 20% of your code takes 80* of your time. 


Only Zinc offers complete portability. 


With Zinc® Application Framework you can 


develop on the platform you prefer. And since 


Zinc is the only one that delivers |00% portability, 


you'll have your application on other platforms as 
fast as you can recompile. It’s part of what makes 
Zinc the most productive—and affordable—tool a 
programmer can use. 


Productivity that leads to opportunity. 


Portability is just one road you'll find a little 
easier. Zinc zips through tedious tasks with C+- 
object orientation and a unique visual develop- 
ment tool. Globalizing your application is as easy 
as translating the text. And Zinc is the only prod- 
uct that supplies |00*% of the source code. 

It all adds up to productivity. Which means 
more profitability. Which is a concept we proba- 
bly don't have to spell out for you. For free infor- 


mation and demonstration software, call toll-free: 


800 638 8665 


Outside the U.S. calli +| 801 785 8900. In Europe call: 
44 (0/181 855:9918, In Asia: +81 (052) 733 4301. Contact Zinc 
electronically at info@zinc,com or GO ZINC on CompuServe. 
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Theres a 
saying that 
good design is invisible. As Ward 
Cunningham puts it, “Good class 
libraries whisper the design in your 
ear." This is the case with zApp, 
which straightforwardly provides 
all the usual classes you'd expect 
in building event-drawn GUI 
programs: a main application class, 
a small hierarchy of event handling 
classes, classes for graphic display, 
window -containing classes, and the 
usual GUI widgets (push buttons, 
check box, list box, and so on). 
There are no radical concepts or 
unpleasant surprises, greatly easing 
any learning curve associated with 
a brand-new API. 
Ray baldés - October, 1992 
The dac- 


Program | 
umentanion 


provided with zApp is little shart 

of superb, zApp 2.0 is a professional 
product which turns platjorm- 
independence into a practical 
proposition by its efficient, versatile 
and function-rich implementation. 





When presenting 
zApp with their 
Editor s Choice Award, Willie 
Watts explained why he “plumped 


EXE 





for zApp”: Of all the C++ encap- 


sulations of Windows in all the bars 
in the world, we both felt this was 
the best attempt we had seen, and 
was something of a landmark in the 
use of this important language. 


JOURNAL OF 2 
peg Cree 


The class design is the most impor- 
tant and most subjective aspect of 
a class library, and I think zApps 

is superb, zApp encapsulates the 
entire underlying native API. 

In other words, if vou want a 
Windows dialog, you get a Windows 
dialogue, not something that looks 
like one. 


» The 1992 Star 
Tech Award for 
ieekane C/C++, and 
Application Frameworks goes to 
Inmark Development Corp 5 zApp 
2.0. zApp is simply the best 
designed application framework 
on the market. Its well-canceived 
classes make Windows programming 
an easier and more manageable 
process-and even fun. [C++ is 





your language of choice, then you 


should be using zApp. Period. 


Sue For general- 
purpose 


applications that arent limited to 
text, basic graphics, and dialog 
boxes, however, | suggest evaluating 
zApp first. Features like advanced 
graphics, printing support, DDE, 
compatibility with third-party 
resource tools, and the ability to 
incerporate custom controls can 
be hard to live without... 

Reprinted fram “COMPUTER SHOPPER” Sept PV 
Canin (03 2i7-Davie Publishing Compaen 


As long as vou write 
vour applications 
using zApp objects, 
you can create 
programs for one compiler or 
environment and recompile them 





with another compiler for a different 


environment without any changes... 
cApp 8 object hierarchy remains the 
most comprehensive I've yet seen 

in. an application framework. 

Reprinted from “PC MAGAZINE” Dee 22, 1992 
Cappniatial J? 20 Dos Publishing Conan: 
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Marketing people say things like 
“zApp is great. [t contains aver 
200 classes." That looks good in 

a slick and glossy brochure, but it 
leaves the fundamental question 
unanswered: Are they good classes? 
They are. zApp s classes are well- 
implemented and easy to use. The 
library covers the fill breadth of 
contemporary functionality and 
offers portability across most major 
operating svstems. 


What I've 
noticed 
about the 
company behind the product is that 
Inmark & customer technical support 
is outstanding (usually a returned 
call within four hours), their BBS 

is full of ereat information, and 
their attention to qualitv 
is stellar. 1 wish all 
software tool providers 
did as well. 





Mark 
Brittingham, 

a user-interface specialist with 
AT&T Bell Labs in Middletown, NJ, 
chose zApp over other frameworks. 
“You can see its built by someone 
who builds applications, © 


Aepriated from “PC WEEK tuly $9 peas 
Capyrighes )203 2-Doi Pabiieing Company 





PCWEEK 


With the 
addition 
of a visual 





screen builder, the final barrier to 
zApp productivity has fallen. For 
quick, form-based applications, 
zApp Factory makes C++ produc- 
tive enough ta be competitive with 
the interpreted languages. For more 
serious applications, the zApp 
Jramework is a superior application 
framework. [ would use it even if 

I were just programming for 
Windows, but the fact that it 
compiles for Windows, Win/NT, 
OS/2, UNIX, and X/Moti/, is 


a nice little hanus. 
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Award winning developers use Award winning tools. 


With the award winning zApp” Developer's Suite, you can quickly build state-of-the-art C++ applications 
that run across fourteen of today’s most popular operating systems. The zApp Developer’s Suite contains 
the latest in drag-and-drop design, prototyping and testing, code generation, and powerful GUI objects. 
Best of all this powerful technology sits on top of zApp, the industry leading application framework in 
use by tens of thousands of developers worldwide. 





For a free demo call: 1-800-346-6275 
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Inmark Development Corporation 2065 Landings Drive. Mountain View, CA 94043 (800) 346-6275, (415) 691-9000 Fax: (415) 691-9099 
in the U.K. and Scandinavia, call PTS/Software Plus at +44 (0) 928 $79900, In France, call PTS/Software Plus ai (05) 908194, In Germany, call ESM Software al 07 702-92 56-0, 
In Italy, call Silicon Valley On-Line at (049) 8719820, In Australia, call Miero Way at (03) 580-1333, BBS: 415-691-9990 + Internet: infoja@inmark.com * CompuServe; GO INMARK 


